DeleteDBA

DeleteDBA

This endpoint permanently removes a specific DBA name associated with a recipient. Once deleted, the DBA can no longer be used for any API requests.

DELETE recipient/deletedba

Run in Postman

Request Body

Field	Type	Description
RecipientId	GUID	TaxBandits-generated unique identifier for the recipient.
PayeeRef	String	Your unique identifier for the recipient.
DBAId	GUID	TaxBandits-generated unique identifier for the DBA.
DBARef	String	Your unique identifier for the DBA.

Response Body

Field	Type	Description
RecipientId	GUID	TaxBandits-generated unique identifier for the recipient.
PayeeRef	String	Your unique identifier for the recipient.
DBAId	GUID	TaxBandits-generated unique identifier for 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.
Errors	Object []	Validation error details.
Id	String	Validation error code.
Name	String	Name of the validation rule that failed.
Message	String	Description of the error.

Payload

Request Params

Sample	Description	Action
Sample 1	Delete a DBA associated with a recipient using RecipientId, PayeeRef, DBARef, and DBAId.

Sample 1

recipient/deletedba?recipientId=d67539c3-0603-4fb7-9a29-3ae15339269a&payeeref=PAYEE001&dbaid=9425a051-a2b9-4cf9-b853-e56246464b3f 

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.

Response: 200

{
  "RecipientIds": "d67539c3-0603-4fb7-9a29-3ae15339269a",
  "PayeeRefs": "PAYEE001",
  "DBAId": "9425a051-a2b9-4cf9-b853-e56246464b3f",
  "DBARef": "STS001",
  "Status": "DELETED",
  "StatusTs": "2026-07-09 11:01:27 -04:00",
  "Errors": null
}

Go Lang

package main

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

func main() {

  url := "<APIURL>/v2.0.0/recipient/deletedba?recipientId=d67539c3-0603-4fb7-9a29-3ae15339269a&payeeref=PAYEE001&dbaid=9425a051-a2b9-4cf9-b853-e56246464b3f%20"
  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/recipient/deletedba?recipientId=d67539c3-0603-4fb7-9a29-3ae15339269a&payeeref=PAYEE001&dbaid=9425a051-a2b9-4cf9-b853-e56246464b3f ',
  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/recipient/deletedba?recipientId=d67539c3-0603-4fb7-9a29-3ae15339269a&payeeref=PAYEE001&dbaid=9425a051-a2b9-4cf9-b853-e56246464b3f%20", 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/recipient/deletedba?recipientId=d67539c3-0603-4fb7-9a29-3ae15339269a&payeeref=PAYEE001&dbaid=9425a051-a2b9-4cf9-b853-e56246464b3f ");
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/recipient/deletedba?recipientId=d67539c3-0603-4fb7-9a29-3ae15339269a&payeeref=PAYEE001&dbaid=9425a051-a2b9-4cf9-b853-e56246464b3f ")

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/recipient/deletedba?recipientId=d67539c3-0603-4fb7-9a29-3ae15339269a&payeeref=PAYEE001&dbaid=9425a051-a2b9-4cf9-b853-e56246464b3f ")
  .method("DELETE", body)
  .addHeader("Authorization", "<ACCESS_TOKEN>")
  .build();
Response response = client.newCall(request).execute();
  

cURL

curl --location --request DELETE '<APIURL>/v2.0.0/recipient/deletedba?recipientId=d67539c3-0603-4fb7-9a29-3ae15339269a&payeeref=PAYEE001&dbaid=9425a051-a2b9-4cf9-b853-e56246464b3f%20' --header 'Authorization: <ACCESS_TOKEN>'