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
| Field | Type | Description |
|---|---|---|
| BusinessId | Guid | TaxBandits-generated unique identifier of the business. |
| PayerRef | string | Your unique identifier for the business. |
| TIN | string | TIN number of the business |
| TINType | string | TIN type of 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 |
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. |
{
"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
}