Managing Businesses

How to retrieve, delete, and update existing businesses.

Use the operations shown below to manage businesses.

Retrieving businesses

To retrieve all businesses, use the GET /businesses operation with no other parameters, as shown in the example below.

curl --request GET \
     --url https://sandbox.bond.tech/api/v0/businesses \
     --header 'Identity: <YOUR_IDENTITY>' \
     --header 'Authorization: <YOUR_AUTHORIZATION>' \
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://sandbox.bond.tech/api/v0/businesses")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Identity"] = <YOUR_IDENTITY>
request["Authorization"] = <YOUR_AUTHORIZATION>

response = http.request(request)
puts response.read_body
const options = {
  method: 'GET',
  headers: {
    Identity: '<YOUR_IDENTITY>',
    Authorization: '<YOUR_AUTHORIZATION>'
  }
};

fetch('https://sandbox.bond.tech/api/v0/businesses', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
import requests

url = "https://sandbox.bond.tech/api/v0/businesses"

headers = {
  "Content-Type": "application/json",
  "Identity": <YOUR_IDENTITY>,
  "Authorization": <YOUR_AUTHORIZATION>
}
response = requests.request("GET", url, headers=headers)

print(response.text)
var client = new RestClient("https://sandbox.bond.tech/api/v0/businesses");
var request = new RestRequest(Method.GET);
request.AddHeader("Identity", "<YOUR_IDENTITY>");
request.AddHeader("Authorization", "<YOUR_AUTHORIZATION>");
IRestResponse response = client.Execute(request);
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://sandbox.bond.tech/api/v0/businesses")
  .get()
  .addHeader("Identity", "<YOUR_IDENTITY>")
  .addHeader("Authorization", "<YOUR_AUTHORIZATION>")
  .build();

Response response = client.newCall(request).execute();

An example of a successful request to retrieve all businesses is shown below.

{
    "addresses": [
        {
            "address_id": "58315f6c-c9c7-4fae-be64-53d6caee69cc",
            "address_type": "MAILING",
            "city": "San Francisco",
            "country": "US",
            "date_created": "2025-04-15T16:53:57.040107+00:00",
            "date_updated": "2025-04-15T16:53:57.040111+00:00",
            "is_primary": false,
            "state": "CA",
            "street": "100 California Ave.",
            "street2": "Suit 600",
            "zip_code": "12345-1234"
        },
        {
            "address_id": "7cac663c-8702-489d-96e3-dcc890e6ab22",
            "address_type": "PHYSICAL",
            "city": "San Francisco",
            "country": "US",
            "date_created": "2025-04-15T16:53:57.040115+00:00",
            "date_updated": "2025-04-15T16:53:57.040115+00:00",
            "is_primary": true,
            "state": "CA",
            "street": "200 California Ave.",
            "street2": "Suit 100",
            "zip_code": "12345-1234"
        }
    ],
    "beneficial_owners": [
        {
            "addresses": [
                {
                    "address_id": "a5e296b1-f22d-4b3f-bdda-4ccb1f2b4cd2",
                    "address_type": "MAILING",
                    "city": "San Francisco",
                    "country": "US",
                    "date_created": "2025-04-15T16:53:57.049055+00:00",
                    "date_updated": "2025-04-15T16:53:57.049059+00:00",
                    "is_primary": true,
                    "state": "CA",
                    "street": "100 California Ave.",
                    "street2": "Suit 600",
                    "zip_code": "12345-1234"
                }
            ],
            "beneficial_owner_id": "7eeaab29-2b60-4c4b-a722-5b5c6682fd0b",
            "date_created": "2025-04-15T16:53:57.026653+00:00",
            "date_updated": "2025-04-15T16:53:57.026657+00:00",
            "dob": "1970-12-12",
            "email": null,
            "first_name": "Morgan",
            "id_expiration": null,
            "id_number": null,
            "id_type": null,
            "is_control_person": null,
            "last_name": "Atelio",
            "middle_name": "",
            "percentage_ownership": null,
            "phone": null,
            "ssn": null
        },
        {
            "addresses": [
                {
                    "address_id": "872c4307-3937-4cec-b882-cf615bf24146",
                    "address_type": "MAILING",
                    "city": "San Francisco",
                    "country": "US",
                    "date_created": "2025-04-15T16:53:57.049063+00:00",
                    "date_updated": "2025-04-15T16:53:57.049063+00:00",
                    "is_primary": true,
                    "state": "CA",
                    "street": "200 California Ave.",
                    "street2": "Suit 600",
                    "zip_code": "12345-1234"
                }
            ],
            "beneficial_owner_id": "840f0063-2f26-4c1d-b68e-bc90dceca583",
            "date_created": "2025-04-15T16:53:57.026669+00:00",
            "date_updated": "2025-04-15T16:53:57.026670+00:00",
            "dob": "1980-04-04",
            "email": null,
            "first_name": "Let",
            "id_expiration": null,
            "id_number": null,
            "id_type": null,
            "is_control_person": null,
            "last_name": "Live",
            "middle_name": "",
            "percentage_ownership": null,
            "phone": null,
            "ssn": null
        }
    ],
    "brand_business_id": null,
    "business_id": "fb7f8ec8-3a80-4328-aeec-400bfab28cb0",
    "business_type": "limited_liability_company",
    "date_created": "2025-04-15T16:53:57.020149+00:00",
    "date_established": null,
    "date_updated": "2025-04-15T16:53:57.020154+00:00",
    "dba_business_name": "Happy Domination Inc.",
    "ein": "11-1111111",
    "email": "[email protected]",
    "industry_type": null,
    "legal_business_name": "Happy Domination Inc.",
    "number_of_employees": null,
    "phone": "+1408-555-7788",
    "website": "https://www.specter.com"
}

To retrieve a single business, use the GET /businesses/{business_id} operation with no other parameters, as shown in the example below.

curl --request GET \
  --url https://sandbox.bond.tech/api/v0/businesses/5e9d3360-c788-435e-9488-949c446639d9 \
  --header 'Identity: <YOUR_IDENTITY>' \
  --header 'Authorization: <YOUR_AUTHORIZATION>' \
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://sandbox.bond.tech/api/v0/businesses/5e9d3360-c788-435e-9488-949c446639d9")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Identity"] = <YOUR_IDENTITY>
request["Authorization"] = <YOUR_AUTHORIZATION>

response = http.request(request)
puts response.read_body
const options = {
  method: 'GET',
  headers: {
    Identity: '<YOUR_IDENTITY>',
    Authorization: '<YOUR_AUTHORIZATION>'
  }
};

fetch('https://sandbox.bond.tech/api/v0/businesses/5e9d3360-c788-435e-9488-949c446639d9', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
import requests

url = "https://sandbox.bond.tech/api/v0/businesses/5e9d3360-c788-435e-9488-949c446639d9"

headers = {
  "Content-Type": "application/json",
  "Identity": <YOUR_IDENTITY>,
  "Authorization": <YOUR_AUTHORIZATION>
}

response = requests.request("GET", url, headers=headers)

print(response.text)
var client = new RestClient("https://sandbox.bond.tech/api/v0/businesses/5e9d3360-c788-435e-9488-949c446639d9");
var request = new RestRequest(Method.GET);
request.AddHeader("Identity", "<YOUR_IDENTITY>");
request.AddHeader("Authorization", "<YOUR_AUTHORIZATION>");
IRestResponse response = client.Execute(request);
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://sandbox.bond.tech/api/v0/businesses/5e9d3360-c788-435e-9488-949c446639d9")
  .get()
  ..addHeader("Identity", "<YOUR_IDENTITY>")
  .addHeader("Authorization", "<YOUR_AUTHORIZATION>")
  .build();

Response response = client.newCall(request).execute();

An example of a response to a successful request to retrieve a business with the business_id of 5e9d3360-c788-435e-9488-949c446639d9 is shown below.

{
	"date_created":"2021-06-18T12:13:22.623220+00:00",
	"date_updated":"2021-06-18T12:13:22.623228+00:00",
	"addresses":[
	{
		"date_created":"2021-06-18T12:13:22.634953+00:00",
		"date_updated":"2021-06-18T12:13:22.634960+00:00",
		"address_id":"d935b32c-65ae-4d94-bcfe-c9e0c91f3a48",
		"address_type":"PHYSICAL",
		"street":"222 California Ave.",
		"street2":"Suit 770",
		"city":"San Francisco",
		"state":"CA",
		"zip_code":"12345-1234",
		"country":"US",
		"is_primary":true
	}
],
	"beneficial_owners":[
	{
		"date_created":"2021-06-18T12:13:22.645164+00:00",
		"date_updated":"2021-06-18T12:13:22.645171+00:00",
		"addresses":[
		{
			"date_created":"2021-06-18T12:13:22.648809+00:00",
			"date_updated":"2021-06-18T12:13:22.648815+00:00",
			"address_id":"c2c1385a-6c95-4fe3-9d33-4eac94c3e48e",
			"address_type":"PHYSICAL",
			"street":"345 California Ave.",
			"street2":"Suit 600",
			"city":"San Francisco",
			"state":"CA",
			"zip_code":"12345-1234",
			"country":"US",
			"is_primary":true
		}
],
		"beneficial_owner_id":"24568387-688e-46d5-8778-60b8c674bb69",
		"first_name":"John",
		"middle_name":NULL,
		"last_name":"Pasakovitch",
		"dob":"1992-12-12"
	}
],
	"business_id":"5e9d3360-c788-435e-9488-949c446639d9",
	"ein":"12-1234588",
	"legal_business_name":"Benny's Deli",
	"dba_business_name":"Benny's",
	"business_type":"partnership",
	"date_established":"2020-01-01",
	"phone":"+12345678989",
	"email":NULL,
	"website":"www.bennys.com"
}

For a complete specification and interactive examples, see Retrieve a business and Retrieve all businesses in the Bond API Reference.

Deleting a business

To delete a business, use the DELETE /businesses/{business_id} operation with no other parameters, as shown in the example below.

curl --request DELETE \
  --url https://sandbox.bond.tech/api/v0/businesses/68954424-a754-4919-9aab-3dfc613b0a1f \
  --header 'Identity: <YOUR_IDENTITY>' \
  --header 'Authorization: <YOUR_AUTHORIZATION>' \
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://sandbox.bond.tech/api/v0/businesses/68954424-a754-4919-9aab-3dfc613b0a1f")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Identity"] = <YOUR_IDENTITY>
request["Authorization"] = <YOUR_AUTHORIZATION>

response = http.request(request)
puts response.read_body
const options = {
  method: 'DELETE',
  headers: {
    Identity: '<YOUR_IDENTITY>',
    Authorization: '<YOUR_AUTHORIZATION>'
  }
};

fetch('https://sandbox.bond.tech/api/v0/businesses/68954424-a754-4919-9aab-3dfc613b0a1f', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
import requests

url = "https://sandbox.bond.tech/api/v0/businesses/68954424-a754-4919-9aab-3dfc613b0a1f"

headers = {
  "Content-Type": "application/json",
  "Identity": <YOUR_IDENTITY>,
  "Authorization": <YOUR_AUTHORIZATION>
}

response = requests.request("DELETE", url, headers=headers)

print(response.text)
var client = new RestClient("https://sandbox.bond.tech/api/v0/businesses/68954424-a754-4919-9aab-3dfc613b0a1f");
var request = new RestRequest(Method.DELETE);
request.AddHeader("Identity", "<YOUR_IDENTITY>");
request.AddHeader("Authorization", "<YOUR_AUTHORIZATION>");
IRestResponse response = client.Execute(request);
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://sandbox.bond.tech/api/v0/businesses/68954424-a754-4919-9aab-3dfc613b0a1f")
  .delete(null)
  .addHeader("Identity", "<YOUR_IDENTITY>")
  .addHeader("Authorization", "<YOUR_AUTHORIZATION>")
  .build();

Response response = client.newCall(request).execute();

An example of a response to a successful request to delete a business with the business_id of 68954424-a754-4919-9aab-3dfc613b0a1f is shown below.

{
  "date_created":"2021-06-24T13:01:29.529849+00:00",
  "date_deleted":"2021-06-24T13:03:22.803407+00:00",
  "addresses":[...],
  "beneficial_owners":[...],
  "business_id":"68954424-a754-4919-9aab-3dfc613b0a1f",
  "ein":"12-1234770",
  "legal_business_name":"Q Takeaways",
  "dba_business_name":"Q Takeaways",
  "business_type":"cooperative",
  "date_established":"2020-01-01",
  "phone":"+12345678770",
  "email":"[email protected]",
  "website":"www.q-takeaways.com"
}

For a complete specification and interactive examples, see Deleting a business in the Bond API Reference.

Updating a business

To update a business, use the PATCH /businesses/{business_id} operation and provide the relevant, optional parameters that you want to update, as shown in the table below.

ParameterTypeDescription
einstringUnique tax identification number used to identify the business with the IRS.
legal_business_namestringLegal name of the business, between 2 and 40 characters.
dba_business_namestringDoing Business As name (trade name), between 2 and 40 characters.
business_typestringType of business. Valid values:

- cooperative
- corporation
- limited_liability_company
- limited_partnership
- nonprofit_organization
- partnership
- sole_proprietorship
date_establisheddateDate of incorporation in YYYY-MM-DD format.
phonestringBusiness phone number.
emailstringBusiness email address.
websitestringBusiness' official website URL.

An example of a request to update a business_type to cooperative is shown below.

curl --request PATCH \
   --url https://sandbox.bond.tech/api/v0/businesses/5e9d3360-c788-435e-9488-949c446639d9 \
  --header 'Identity: <YOUR_IDENTITY>' \
  --header 'Authorization: <YOUR_AUTHORIZATION>' \
  --header 'Content-Type: application/json' \
  --data '
{
     "business_type": "cooperative"
}
require 'uri'
require 'net/http'
require 'openssl'

url = URI("https://sandbox.bond.tech/api/v0/businesses/5e9d3360-c788-435e-9488-949c446639d9")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request["Identity"] = <YOUR_IDENTITY>
request["Authorization"] = <YOUR_AUTHORIZATION>
request.body = "{\"business_type\":\"cooperative\"}"

response = http.request(request)
puts response.read_body
const options = {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    Identity: 'de9960e3-5af8-455a-9034-bbd4072d23d4',
    Authorization: 'RBF0ye9R5m9cpaOSRk/vY8/VqCVGWy/AV/qdZMPG/6s58aoK6WKyZ8D4W6jemiUY'
  },
  body: JSON.stringify({business_type: 'cooperative'})
};

fetch('https://sandbox.bond.tech/api/v0/businesses/5e9d3360-c788-435e-9488-949c446639d9', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));
import requests

url = "https://sandbox.bond.tech/api/v0/businesses/5e9d3360-c788-435e-9488-949c446639d9"

payload = {"business_type": "cooperative"}
headers = {
  "Content-Type": "application/json",
  "Identity": <YOUR_IDENTITY>,
  "Authorization": <YOUR_AUTHORIZATION>
}

response = requests.request("PATCH", url, json=payload, headers=headers)

print(response.text)
var client = new RestClient("https://sandbox.bond.tech/api/v0/businesses/5e9d3360-c788-435e-9488-949c446639d9");
var request = new RestRequest(Method.PATCH);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Identity", "<YOUR_IDENTITY>");
request.AddHeader("Authorization", "<YOUR_AUTHORIZATION>");
request.AddParameter("application/json", "{\"business_type\":\"cooperative\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"business_type\":\"cooperative\"}");
Request request = new Request.Builder()
  .url("https://sandbox.bond.tech/api/v0/businesses/5e9d3360-c788-435e-9488-949c446639d9")
  .patch(body)
  .addHeader("Content-Type", "application/json")
  .addHeader("Identity", "<YOUR_IDENTITY>")
  .addHeader("Authorization", "<YOUR_AUTHORIZATION>")
  .build();

Response response = client.newCall(request).execute();

An example of a response to a successful request to update the business type to cooperative is shown below.

{
	"date_created":"2021-06-18T12:13:22.623220+00:00",
	"date_updated":"2021-06-24T12:50:57.631590+00:00",
	"addresses":[...],
	"beneficial_owners":[...],
	"business_id":"5e9d3360-c788-435e-9488-949c446639d9",
	"ein":"12-1234588",
	"legal_business_name":"Benny's Deli",
	"dba_business_name":"Benny's",
	"business_type":"cooperative",
	"date_established":"2020-01-01",
	"phone":"+12345678989",
	"email":NULL,
	"website":"www.bennys.com"
}

For a complete specification and interactive examples, see Update a business in the Bond API Reference.