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.
Parameter | Type | Description |
---|---|---|
ein | string | Unique tax identification number used to identify the business with the IRS. |
legal_business_name | string | Legal name of the business, between 2 and 40 characters. |
dba_business_name | string | Doing Business As name (trade name), between 2 and 40 characters. |
business_type | string | Type of business. Valid values: - cooperative - corporation - limited_liability_company - limited_partnership - nonprofit_organization - partnership - sole_proprietorship |
date_established | date | Date of incorporation in YYYY-MM-DD format. |
phone | string | Business phone number. |
email | string | Business email address. |
website | string | Business' 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.
Updated 13 days ago