DeleteDBA

DeleteDBA

This endpoint permanently removes a specific DBA name associated with a business. Once deleted, the DBA can no longer be used for W-9 requests, transactions, or recipient copy distribution.

DELETEbusiness/deletedba

Run in Postman

Request Body

Field	Type	Description
BusinessId	Guid	TaxBandits-generated unique identifier of the business.
DBAId	Guid	TaxBandits-generated unique identifier of the DBA.
DBARef	string	Your unique identifier for the DBA.

Response Body

Field	Type	Description
BusinessId	GUID	TaxBandits-generated unique Identifier of the business.
PayerRef	String	Your unique identifier for the business.
SuccessRecords	Object []	DBA records that were deleted successfully.
DBAId	GUID	TaxBandits-generated unique identifier of the DBA.
DBARef	string	Your unique identifier for the DBA.
Status	string	Status of the deletion.
StatusTs	string	Date and time the deletion was completed.
ErrorRecords	Object []	DBA records that failed to delete
DBAId	GUID	Identifier of the failed DBA
DBARef	string	Your unique identifier for the DBA
Error	object []	Details about the error
Name	string	Name of the validation rule that failed
ID	string	Validation error code
Message	string	Description of the error

Payload

Request Params

Sample	Description	Action
Sample 1	Delete a DBA associated with a business using BusinessId, PayerRef, DBARef, and DBAId.

Sample 1

Business/deletedba?businessId=519a84f4-5e56-496a-82f3-18f51fdf3d75&PayerRef=ABC123&DBARef=DBA1001&DBAId=b2c3d4e5-2222-3333-4444-555566667777

Response JSON

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

Response: 200

{
  "BusinessId": "519a84f4-5e56-496a-82f3-18f51fdf3d75",
  "PayerRef": "ABC123",
  "SuccessRecords": [
    {
      "DBAId": "b2c3d4e5-2222-3333-4444-555566667777",
      "DBARef": "DBA1001",
      "Status": "DELETED",
      "StatusTs": "2026-03-19T06:26:16-04:00"
    }
  ],
  "ErrorRecords": [
    {
      "DBAId": "b2c3d4e5-2222-3333-4444-888866667777",
      "DBARef": "ABC123",
      "Errors": [
        {
          "Id": null,
          "Name": null,
          "Message": null
        }
      ]
    }
  ]
}

Go Lang

package main

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

func main() {

  url := "<APIURL>/v2.0.0/Business/deletedba?businessId=519a84f4-5e56-496a-82f3-18f51fdf3d75&PayerRef=ABC123&DBARef=DBA1001&DBAId=b2c3d4e5-2222-3333-4444-555566667777"
  method := "DELETE"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "<ACCESS_TOKEN>")

  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(string(body))
}

Node.js

  const axios = require('axios');

  let config = {
    method: 'delete',
    maxBodyLength: Infinity,
    url: '<APIURL>/v2.0.0/Business/deletedba?businessId=519a84f4-5e56-496a-82f3-18f51fdf3d75&PayerRef=ABC123&DBARef=DBA1001&DBAId=b2c3d4e5-2222-3333-4444-555566667777',
    headers: { 
      'Authorization': '<ACCESS_TOKEN>'
    }
  };

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

Python

  import http.client

  conn = http.client.HTTPSConnection("<APIURL>")
  payload = ''
  headers = {
    'Authorization': '<ACCESS_TOKEN>'
  }
  conn.request("DELETE", "/v2.0.0/Business/deletedba?businessId=519a84f4-5e56-496a-82f3-18f51fdf3d75&PayerRef=ABC123&DBARef=DBA1001&DBAId=b2c3d4e5-2222-3333-4444-555566667777", payload, headers)
  res = conn.getresponse()
  data = res.read()
  print(data.decode("utf-8"))

.NET C#

  var client = new HttpClient();
  var request = new HttpRequestMessage(HttpMethod.Delete, "<APIURL>/v2.0.0/Business/deletedba?businessId=519a84f4-5e56-496a-82f3-18f51fdf3d75&PayerRef=ABC123&DBARef=DBA1001&DBAId=b2c3d4e5-2222-3333-4444-555566667777");
  request.Headers.Add("Authorization", "<ACCESS_TOKEN>");
  var response = await client.SendAsync(request);
  response.EnsureSuccessStatusCode();
  Console.WriteLine(await response.Content.ReadAsStringAsync());

Ruby

  require "uri"
  require "net/http"

  url = URI("<APIURL>/v2.0.0/Business/deletedba?businessId=519a84f4-5e56-496a-82f3-18f51fdf3d75&PayerRef=ABC123&DBARef=DBA1001&DBAId=b2c3d4e5-2222-3333-4444-555566667777")

  http = Net::HTTP.new(url.host, url.port);
  request = Net::HTTP::Delete.new(url)
  request["Authorization"] = "<ACCESS_TOKEN>"

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

Java

  OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
  MediaType mediaType = MediaType.parse("text/plain");
  RequestBody body = RequestBody.create(mediaType, "");
  Request request = new Request.Builder()
    .url("<APIURL>/v2.0.0/Business/deletedba?businessId=519a84f4-5e56-496a-82f3-18f51fdf3d75&PayerRef=ABC123&DBARef=DBA1001&DBAId=b2c3d4e5-2222-3333-4444-555566667777")
    .method("DELETE", body)
    .addHeader("Authorization", "<ACCESS_TOKEN>")
    .build();
  Response response = client.newCall(request).execute();

cURL

  curl --location --request DELETE '<APIURL>/v2.0.0/Business/deletedba?businessId=519a84f4-5e56-496a-82f3-18f51fdf3d75&PayerRef=ABC123&DBARef=DBA1001&DBAId=b2c3d4e5-2222-3333-4444-555566667777'   --header 'Authorization: <ACCESS_TOKEN>'