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/AddDBA 

Request Body

Field	Type	Description
BusinessId	Guid	Use the unique Business ID (Generated by TaxBandits), you received in the response of the Business CREATE Endpoint.
DBADetails	object[]	Contains name, Reference ID, and address of the DBA.
SequenceId	string	Get unique reference ID for the submission that can be used to identify a particular DBA. The SequenceID will be returned in the response for your reference. Size Range: 50
DBAName	string	Name of the DBA. Size Range: ..75
DBARef	string	An Unique identifier for each DBA. This identifier can be used in future references for the DBA in the API. Size Range: 1-50
IsForeign	Boolean	When true, identifies the business address with a foreign address.
USAddress	object	if IsForeign is false, pass US address of the business
Address1	string	Employer/Payer's US address (street address or post office box of that locality). Size Range: ..46
Address2	string	Optional Employer/Payer's suite or apartment. Size Range: ..46
City	string	Employer/Payer's city. Size Range: ..50
State	string	Employer/Payer's state code. Refer Static values. Size Range: 2 Allowed values "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", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"
ZipCd	string	Employer/Payer's zip code. Size Range: 5..10
ForeignAddress	object	if IsForeign is true, pass foreign address of the business.
Address1	string	Address of the Employer/Payer (street address or post office box of that locality) Size Range: ..50
Address2	string	OptionalEmployer/Payer's suite or apartment. Size Range: ..50
City	string	Employer/Payer's city. Size Range: ..50
ProvinceOrStateNm	string	Employer/Payer's province or state name. Size Range: ..50
Country	string	Employer/Payer's country. Size Range: 2 Allowed values "AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
PostalCd	string	Postal Code the State where the Employer/Payer is based out of. Size Range: ..16

Response Body

Field	Type	Description
StatusCode	number	Returns the status codes like 200, 300 etc.
StatusName	string	Name of the status code.
StatusMessage	string	Detailed status message
BusinessId	Guid	Unique Identifier of a business
DBADetails	object[]	Pulls DBA detail records with Success and Error statuses.
DBAName	string	Name of the DBA.
DBARef	string	Unique identifier for each DBA. This identifier can be used in future references of the DBA in the API.
DBAId	string	Unique Identifier for the DBA.
Errors	object[]	Shows detailed error information.
Name	string	Name of the validation error.
ID	string	Returns the validation error ID.
Message	string	Description of the validation error.
Error	object	Shows detailed error information.
Name	string	Name of the validation error.
ID	string	Returns the validation error ID.
Message	string	Description of the validation error.

Request JSON

{
  "BusinessId": "203b32af-6a5d-4faa-91f9-adad5753fa5f",
  "DBADetails": [
    {
      "SequenceId": "01",
      "DBAName": "Snowdaze LLC",
      "DBARef": "db123",
      "IsForeign": false,
      "USAddress": {
        "Address1": "1752 Kinsey Rd",
        "Address2": "Main St",
        "City": "Dothan",
        "State": "AL",
        "ZipCd": "36303"
      },
      "ForeignAddress": null
    },
    {
      "SequenceId": "02",
      "DBAName": "XYZ LLC",
      "DBARef": "db234",
      "IsForeign": false,
      "USAddress": {
        "Address1": "234 Celanese Rd",
        "Address2": null,
        "City": "Rockhill",
        "State": "SC",
        "ZipCd": "27390"
      },
      "ForeignAddress": null
    }
  ] 
}

Response JSON

Success Response - This is a sample response for successful API requests.

{
  "StatusCode": 200,
  "StatusName": "OK",
  "StatusMessage": "Successful API Call",
  "BusinessId": "203b32af-6a5d-4faa-91f9-adad5753fa5f",
  "DBADetails": [
    {
      "DBAName": "Snowdaze LLC",
      "DBARef": "db1234",
      "DBAId": "566e1623-3c07-4d15-9fcc-00cad9a3a5d5",
      "Errors": {
        "ID": null,
        "Name": null,
        "Message": null
      }
    },
    {
      "DBAName": "Snowdaze LLC",
      "DBARef": "db123",
      "DBAId": "c5f92374-7b0e-4979-a6e1-0f8eeb7e13d7",
      "Errors": null
    }
  ],
  "Error": null
}