Skip to main content
Version: 2.0

AddDBA

AddDBA

If the business operates under multiple DBA names or Trade Names other than the name registered with the IRS, you can add them using this endpoint. This will allow the business to request a W-9, send transactions, and distribute 1099s to the recipients under the DBA name instead of the legal name.

Key Points​

  • Before creating a DBA, make sure the corresponding business has already been added to the TaxBandits API.
  • You can add multiple DBA names under the same business, as needed.
  • Each DBA is assigned a unique DBAId by TaxBandits.
  • You can also assign your own DBARef for cross-referencing in your system.
POST business/addba
Run in Postman

Request Body

FieldTypeDescription
BusinessIdGuidTaxBandits-generated unique identifier of the business.
PayerRefStringYour unique identifier for the business.
DBADetailsobject[]Information about the DBA.
SequenceIdstringOptional A unique reference ID that can be used to identify a particular DBA. The Sequence ID will be returned in the Response for your reference.
Size Range: 50
DBANmstringName of the DBA.
Size Range: 75
DBARefstringYour unique identifier for this DBA.
Size Range: 1-50
AddressObjectAddress information of DBA
Address1StringStreet address or PO Box.

Size Range: 46
Address2StringOptional Suite or apartment number.

Size Range: 46
CityStringDBA's city.

Size Range: 50
ProvinceOrStateStringDBA's province or state name.

Allowed values
When the country code is US :
"AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"
When the country code is CA:
"AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT"

Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCdStringDBA's ZIP code.

Size Range: 5-16
CountryStringDBA's 2-character country code.

Allowed values: "US", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AT", "AU", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DO", "DM", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RO", "RS", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TK", "TF", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WA", "WF", "WI", "YM", "ZA", "ZI"

Response Body

FieldTypeDescription
BusinessIdGUIDTaxBandits-generated unique identifier of the business.
PayerRefStringYour unique identifier for the business.
DBADetailsObject[]Details of the DBA.
SuccessRecordsObject []DBA records that were added successfully.
SequenceIdStringA unique reference ID for the submission that can be used to identify a particular DBA.
DBAIdGUIDTaxBandits-generated unique identifier of the DBA. Store this for future DBA operations.
DBARefStringYour unique identifier for the DBA.
DBANmStringName of the DBA as registered.
ErrorRecordsObject[]Records that failed to process.
SequenceIdStringA unique reference ID for the submission that can be used to identify a particular DBA.
DBAIdGUIDTaxBandits-generated unique identifier of the DBA.
DBARefStringYour unique identifier for the DBA.
DBANmStringName of the DBA as registered.
ErrorsObject[]Reference ID of the failed record.
IdStringValidation error code.
NameStringName of the validation rule that failed.
MessageStringDescription of what went wrong
Request Json
SampleDescriptionAction
Sample 1
Add DBA details to a business using PayerRef.
Sample 1
{
  "BusinessId": "fe6b952e-439f-4079-ac6d-92d3e799e903",
  "PayerRef": "84733",
  "DBADetails": [
      {
          "SequenceId": "01",
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1002",
          "Address": {
                  "Address1": "1600 Pennsylvania Avenue NW",
                  "Address2": null,
                  "City": "Washington",
                  "ProvinceOrState": "DC",
                  "ZipCd": "20500",
                  "Country": "US"
              }
      }
  ]
}
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.
300
Multi-status Response - You'll get the below response when multiple statuses are included.
401
Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.
{
  "StatusCode": 200,
  "BusinessId": "fe6b952e-439f-4079-ac6d-92d3e799e903",
  "PayerRef": "Pe77162",
  "DBADetails": {
      "SuccessRecords": [
          {
              "SequenceId": "01",
              "DBAId": "7e81628b-b581-4054-b3ec-cc4400602504",
              "DBARef": "DBA1002",
              "DBANm": "Iceberg Icecreams"
          }
      ],
      "ErrorRecords": null
  },
  "Errors": null
}