Version: 2.0.0

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

Run in Postman

Request Body

Field	Type	Description
BusinessId	Guid	TaxBandits-generated unique identifier of the business.
PayerRef	String	Your unique identifier for the business.
DBADetails	object[]	Information about the DBA.
SequenceId	string	Optional 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
DBANm	string	Name of the DBA. Size Range: 75
DBARef	string	Your unique identifier for this DBA. Size Range: 1-50
Address	Object	Address information of DBA
Address1	String	Street address or PO Box. Size Range: 46
Address2	String	Optional Suite or apartment number. Size Range: 46
City	String	DBA's city. Size Range: 50
ProvinceOrState	String	DBA'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.
ZipCd	String	DBA's ZIP code. Size Range: 5-16
Country	String	DBA'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

Field	Type	Description
BusinessId	GUID	TaxBandits-generated unique identifier of the business.
PayerRef	String	Your unique identifier for the business.
DBADetails	Object[]	Details of the DBA.
SuccessRecords	Object[]	DBA records that were added successfully.
SequenceId	String	A unique reference ID for the submission that can be used to identify a particular DBA.
DBAId	GUID	TaxBandits-generated unique identifier of the DBA. Store this for future DBA operations.
DBARef	String	Your unique identifier for the DBA.
DBANm	String	Name of the DBA as registered.
ErrorRecords	Object[]	Records that failed to process.
SequenceId	String	A unique reference ID for the submission that can be used to identify a particular DBA.
DBAId	GUID	TaxBandits-generated unique identifier of the DBA.
DBARef	String	Your unique identifier for the DBA.
DBANm	String	Name of the DBA as registered.
Errors	Object[]	Reference ID of the failed record.
Id	String	Validation error code.
Name	String	Name of the validation rule that failed.
Message	String	Description of what went wrong

Request Json

Sample	Description	Action
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

Sample	Description	Action
200	Success Response - This is a sample response for successful API requests.
207	Multi-status Response - You'll get the below response when multiple statuses are included.
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": {
    "SuccessRecords": [
      {
        "SequenceId": "01",
        "DBAId": "7e81628b-b581-4054-b3ec-cc4400602504",
        "DBARef": "DBA1002",
        "DBANm": "Iceberg Icecreams"
      }
    ],
    "ErrorRecords": null
  },
  "Errors": null
}

  package main

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

  func main() {
      url := "<APIURL>/v2.0.0/business/adddba"
      method := "POST"

      payload := strings.NewReader(`{
          "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"
                  }
              }
          ]
      }`)

      client := &http.Client{}

      req, err := http.NewRequest(method, url, payload)
      if err != nil {
          fmt.Println(err)
          return
      }

      req.Header.Add("Authorization", "<ACCESS_TOKEN>")
      req.Header.Add("Content-Type", "application/json")

      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("Status:", res.Status)
      fmt.Println(string(body))
  }   

  const axios = require('axios');
  let data = JSON.stringify({
  "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"
      }
      }
  ]
  });

  let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: '<APIURL>/v2.0.0/business/adddba',
  headers: { 
      'Authorization': '<ACCESS_TOKEN>', 
      'Content-Type': 'application/json'
  },
  data : data
  };

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

  import http.client
  import json

  conn = http.client.HTTPSConnection("<APIURL>")
  payload = json.dumps({
  "BusinessId": "fe6b952e-439f-4079-ac6d-92d3e799e903",
  "PayerRef": "84733",
  "DBADetails": [
      {
      "SequenceId": "01",
      "DBANm": "Iceberg Icecreams",
      "DBARef": "DBA1002",
      "Address": {
          "Address1": "1600 Pennsylvania Avenue NW",
          "Address2": None,
          "City": "Washington",
          "ProvinceOrState": "DC",
          "ZipCd": "20500",
          "Country": "US"
      }
      }
  ]
  })
  headers = {
  'Authorization': '<ACCESS_TOKEN>',
  'Content-Type': 'application/json'
  }
  conn.request("POST", "/v2.0.0/business/adddba", payload, headers)
  res = conn.getresponse()
  data = res.read()
  print(data.decode("utf-8"))
  

  var client = new HttpClient();
  var request = new HttpRequestMessage(HttpMethod.Post, "<APIURL>/v2.0.0/business/adddba");
  request.Headers.Add("Authorization", "<ACCESS_TOKEN>");
  var content = new StringContent("{
	"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"
			}
		}
	]
}", null, "application/json");
  request.Content = content;
  var response = await client.SendAsync(request);
  response.EnsureSuccessStatusCode();
  Console.WriteLine(await response.Content.ReadAsStringAsync());

  

  require "uri"
  require "json"
  require "net/http"

  url = URI("<APIURL>/v2.0.0/business/adddba")

  http = Net::HTTP.new(url.host, url.port);
  request = Net::HTTP::Post.new(url)
  request["Authorization"] = "<ACCESS_TOKEN>"
  request["Content-Type"] = "application/json"
  request.body = JSON.dump({
  "BusinessId": "fe6b952e-439f-4079-ac6d-92d3e799e903",
  "PayerRef": "84733",
  "DBADetails": [
      {
      "SequenceId": "01",
      "DBANm": "Iceberg Icecreams",
      "DBARef": "DBA1002",
      "Address": {
          "Address1": "1600 Pennsylvania Avenue NW",
          "Address2": nil,
          "City": "Washington",
          "ProvinceOrState": "DC",
          "ZipCd": "20500",
          "Country": "US"
      }
      }
  ]
  })

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

  

  OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
  MediaType mediaType = MediaType.parse("application/json");
  RequestBody body = RequestBody.create(mediaType, "{
	"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"
			}
		}
	]
}");
  Request request = new Request.Builder()
  .url("<APIURL>/v2.0.0/business/adddba")
  .method("POST", body)
  .addHeader("Authorization", "<ACCESS_TOKEN>")
  .addHeader("Content-Type", "application/json")
  .build();
  Response response = client.newCall(request).execute();
  

  curl --location '<APIURL>/v2.0.0/business/adddba'   --header 'Authorization: <ACCESS_TOKEN>'   --header 'Content-Type: application/json'   --data '{
      "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"
              }
          }
      ]
  }'
  

W-9/W-8 Automation

1099 Automation

TIN Matching

W-2 Automation

941/940 Automation

1098-T Automation

ACA Automation

Extension Automation

1042-S Automation

Supported Forms

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Healthcare Market Research Platforms

AddDBA

AddDBA

Key Points​

Request Body

Response Body

Sample 1

Response: 200

Key Points