Skip to main content
Version: 2.0

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 

Request Body

FieldTypeDescription
BusinessIdGuidTaxBandits-generated unique identifier of the business.
PayerRefstringYour unique identifier for the business.
TINstringTIN number of the business
TINTypestringTIN type of the business
PagenumberPage number to retrieve. Starts at 1.
PageSizenumberNumber of DBA records per page. Maximum: 100

Response Body

FieldTypeDescription
BusinessIdGUIDTaxBandits-generated unique Identifier of the business.
PayerRefStringYour unique identifier for the business.
DBADetailsobject []DBA details of the business.
DBANmStringName of the DBA
DBARefStringTaxBandits-generated unique identifier of the DBA.
AddressobjectThe address details of the DBA
Address1StringStreet address or post office box of the DBA.
Address2StringDBA's suite or apartment.
CityStringDBA's city.
ProvinceOrStateStringDBA's province or state name.
ZipCdStringDBA's zip code.
CountryStringDBA's country.
PagenumberRequested page number
PageSizenumberRequested page size
TotalRecordsnumberTotal number of DBA records for this business
TotalPagesnumberTotal number of pages available
Request Json
SampleDescriptionAction
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
SampleDescriptionAction
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.
{
"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
}