ListDBA

ListDBA

This endpoint retrieves all DBA names associated with a specific business. Results are paginated. Use the Page and PageSize parameters to control how many records are returned per request.

GET business/listdba 

Run in Postman

Request Params

Field	Type	Description
BusinessId	Guid	TaxBandits-generated unique identifier of the business.
PayerRef	string	Your unique identifier for the business.
Page	number	Page number to retrieve. Starts at 1.
PageSize	number	Number of DBA records per page. Maximum: 100

Response Body

Field	Type	Description
BusinessId	GUID	TaxBandits-generated unique Identifier of the business.
PayerRef	String	Your unique identifier for the business.
DBADetails	object []	DBA details of the business.
DBANm	String	Name of the DBA
DBARef	String	TaxBandits-generated unique identifier of the DBA.
Address	object	The address details of the DBA
Address1	String	Street address or post office box of the DBA.
Address2	String	DBA's suite or apartment.
City	String	DBA's city.
ProvinceOrState	String	DBA's province or state name.
ZipCd	String	DBA's zip code.
Country	String	DBA's country.
Page	number	Requested page number
PageSize	number	Requested page size
TotalRecords	number	Total number of DBA records for this business
TotalPages	number	Total number of pages available

Payload

Request Json

Sample	Description	Action
Sample 1	List DBA records for a business using BusinessId, PayerRef, and pagination.

Sample 1

business/listdba?businessId=fe6b952e-439f-4079-ac6d-92d3e799e903&PayerRef=Pe77162&Page=1&PageSize=25

Response Json

Sample	Description	Action
200	Success Response - This is a sample response for successful API requests.
400	Bad Request Response - You'll get the below response when your API requests contain any validation errors.
401	Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.

Response: 200

{
  "BusinessId": "fe6b952e-439f-4079-ac6d-92d3e799e903",
  "PayerRef": "Pe77162",
  "DBADetails": [
    {
      "DBANm": "Icecreams",
      "DBARef": "DBA1002",
      "DBAId": "7e81628b-b581-4054-b3ec-cc4400602504",
      "Address": {
        "Address1": "1600 Pennsylvania Avenue NW",
        "Address2": "",
        "City": "Washington",
        "ProvinceOrState": "DC",
        "ZipCd": "20500",
        "Country": "US"
      },
      "CreatedTime": "2026-07-07 10:04:17 -04:00",
      "LastUpdatedTime": "2026-07-07 10:10:16 -04:00"
    },
    {
      "DBANm": "Iceberg Icecreams",
      "DBARef": "DBA1001",
      "DBAId": "8d1d11f9-bb66-4b24-a31a-54c90103c321",
      "Address": {
        "Address1": "1600 Pennsylvania Avenue NW",
        "Address2": "",
        "City": "Washington",
        "ProvinceOrState": "DC",
        "ZipCd": "20500",
        "Country": "US"
      },
      "CreatedTime": "2026-07-07 10:02:33 -04:00",
      "LastUpdatedTime": "2026-07-07 10:02:33 -04:00"
    }
  ],
  "Page": 1,
  "PageSize": 100,
  "TotalRecords": 2,
  "TotalPages": 1,
  "Errors": null
}

Go Lang

package main

import (
  "fmt"
  "net/http"
  "io"
)

func main() {

  url := "<APIURL>/v2.0.0/business/listdba?BusinessId=fe6b952e-439f-4079-ac6d-92d3e799e903&PayerRef=2&Page=1&PageSize=10"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "<ACCESS_TOKEN>")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}    

Node.js

const axios = require('axios');

let config = {
  method: 'get',
  maxBodyLength: Infinity,
  url: '<APIURL>/v2.0.0/business/listdba?BusinessId=fe6b952e-439f-4079-ac6d-92d3e799e903&PayerRef=2&Page=1&PageSize=10',
  headers: { 
    'Authorization': '<ACCESS_TOKEN>'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Python

import http.client

conn = http.client.HTTPSConnection("<APIURL>")
payload = ''
headers = {
  'Authorization': '<ACCESS_TOKEN>'
}
conn.request("GET", "/v2.0.0/business/listdba?BusinessId=fe6b952e-439f-4079-ac6d-92d3e799e903&PayerRef=2&Page=1&PageSize=10", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
  

.NET C#

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "<APIURL>/v2.0.0/business/listdba?BusinessId=fe6b952e-439f-4079-ac6d-92d3e799e903&PayerRef=2&Page=1&PageSize=10");
request.Headers.Add("Authorization", "<ACCESS_TOKEN>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
  

Ruby

require "uri"
require "net/http"

url = URI("<APIURL>/v2.0.0/business/listdba?BusinessId=fe6b952e-439f-4079-ac6d-92d3e799e903&PayerRef=2&Page=1&PageSize=10")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Get.new(url)
request["Authorization"] = "<ACCESS_TOKEN>"

response = http.request(request)
puts response.read_body
  

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("<APIURL>/v2.0.0/business/listdba?BusinessId=fe6b952e-439f-4079-ac6d-92d3e799e903&PayerRef=2&Page=1&PageSize=10")
  .method("GET", body)
  .addHeader("Authorization", "<ACCESS_TOKEN>")
  .build();
Response response = client.newCall(request).execute();
  

cURL

curl --location '<APIURL>/v2.0.0/business/listdba?BusinessId=fe6b952e-439f-4079-ac6d-92d3e799e903&PayerRef=2&Page=1&PageSize=10' --header 'Authorization: <ACCESS_TOKEN>'