Creating a business

To create a Business resource, use the POST /businesses operation and provide parameters, as shown in the following table:

▶ Run in Postman

`business` object

Parameter	Type	Description
addresses ^required	array	Array of one or more physical or mailing addresses.
beneficial_owners	array	Array of one or more beneficial owners.
`business_type`	string	Type of business. Valid values: - `cooperative` - `corporation` - `limited_liability_company` - `limited_partnership` - `nonprofit_organization` - `partnership` - `sole_proprietorship`
`date_established`	date	Business' date of incorporation in `YYYY-MM-DD` format.
`dba_business_name`	string	Doing Business As name (trade name).
`ein`	string	Unique type of tax identification number used to identify the business with the IRS.
`email`	string	Business contact email address.
`legal_business_name` ^required	string	Legal name of the business.
`phone`	string	Business phone number with or without hyphens.
`website`	string	Business website URL.

`addresses` array

The addresses array is within the business object or beneficial_owners array and has the following structure.

Parameter	Type	Description
`address_id`	string	Unique identifier for the address assigned by the system.
`address_type` ^required	string	Either `MAILING` or `PHYSICAL`.
`city` ^required	string	Business city name. Between 2 and 40 characters.
`country` ^required	string	ISO 3166-1 alpha-2 country code, maximum two characters.
`date_created`	string	The timestamp created by the system in the `YYYY-MM-DDThh:mm:ss.ssssss+00:00` format.
`is_primary` ^required	boolean	Is this the primary address; valid values are `true` or `false`. Note: This field is deprecated.
`state` ^required	string	Within the U.S., use the two-character state code. Outside the U.S., can use between 2 and 20 characters.
`street` ^required	string	Business address 1st line. Between 1 and 40 characters. May contain only alphanumeric and these special characters `. , _ - #`
`street2`	string	Business address 2nd line. Between 1 and 40 characters.
`zip_code` ^required	string	Within the U.S., use the five-digit or nine-digit zip code. Outside the U.S., can use between 2 and 20 characters.

`beneficial_owners` array

The required beneficial_owners array is within the Business object and has the following structure.

Parameter	Type	Description
addresses ^required	array	One or more official address.
`beneficial_owner_id`	string	Unique identifier for the beneficial owner assigned by the system.
`date_created`	string	The timestamp created by the system in the `YYYY-MM-DDThh:mm:ss.ssssss+00:00` format.
`dob` ^required	string	Date of birth in `YYYY-MM-DD` format.
`email`	string	Beneficial owner's contact email address.
`first_name` ^required	string	First name, between 1 and 20 characters. Must start with a letter and can only contain letters, spaces, and apostrophes.
`id_expiration`	string	The expiration date on the beneficial owner's `id_type` in the `YYYY-MM-DD`format .
`id_number`	string	The identifier used on the beneficial owner's `id_type`.
`id_type`	string	The type of identification used, such as `PASSPORT`, `SSN`, and `DRIVERS_LICENSE`.
`is_control_person`	string	Is this individual a senior officer, such as CEO, CFO, or COO?
`last_name` ^required	string	Last name, between 2 and 20 characters. Must start with a letter and can only contain letters, spaces, and apostrophes.
`middle_name`	string	Middle name, between 1 and 20 characters. Must start with a letter and can only contain letters, spaces, and apostrophes.
`percentage_ownership`	string	The percentage the individual owns of the entity.
`phone`	string	The beneficial owner's phone number.
`ssn`	string	The beneficial owner's Social Security Number.

Example request

The following is an example of a request to create a business resource.

curl --request POST \
  --url https://sandbox.bond.tech/api/v0/businesses \
  --header 'Identity: <YOUR_IDENTITY>' \
  --header 'Authorization: <YOUR_AUTHORIZATION>' \
  --header 'Content-Type: application/json' \
  --data
'{
  "addresses": [
    {
      "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": [
    {
      "dob": "1992-12-12",
      "first_name": "John",
      "last_name": "Pasakovitch",
      "addresses": [
        {
          "address_type": "PHYSICAL",
          "street": "345 California Ave.",
          "street2": "Suit 600",
          "city": "San Francisco",
          "state": "CA",
          "zip_code": "12345-1234",
          "country": "US",
          "is_primary": true
        }
      ]
    }
  ],
  "ein": "12-1234588",
  "legal_business_name": "Benny\'s Deli",
  "dba_business_name": "Benny\'s",
  "business_type": "partnership",
  "date_established": "2020-01-01",
  "phone": "+12345678989",
  "website": "www.bennys.com"
}'

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::Post.new(url)
request["Content-Type"] = 'application/json'
request["Identity"] = <YOUR_IDENTITY>
request["Authorization"] = <YOUR_AUTHORIZATION>
request.body = "{\"addresses\":[{\"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\":[{\"dob\":\"1992-12-12\",\"first_name\":\"John\",\"last_name\":\"Pasakovitch\",\"addresses\":[{\"address_type\":\"PHYSICAL\",\"street\":\"345 California Ave.\",\"street2\":\"Suit 600\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip_code\":\"12345-1234\",\"country\":\"US\",\"is_primary\":true}]}],\"ein\":\"12-1234588\",\"legal_business_name\":\"Benny's Deli\",\"dba_business_name\":\"Benny's\",\"business_type\":\"partnership\",\"date_established\":\"2020-01-01\",\"phone\":\"+12345678989\",\"website\":\"www.bennys.com\"}"

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

const options = {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Identity: '<YOUR_IDENTITY>',
    Authorization: '<YOUR_AUTHORIZATION>'
  },
  body: JSON.stringify({
    addresses: [
      {
        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: [
      {
        dob: '1992-12-12',
        first_name: 'John',
        last_name: 'Pasakovitch',
        addresses: [
          {
            address_type: 'PHYSICAL',
            street: '345 California Ave.',
            street2: 'Suit 600',
            city: 'San Francisco',
            state: 'CA',
            zip_code: '12345-1234',
            country: 'US',
            is_primary: true
          }
        ]
      }
    ],
    ein: '12-1234588',
    legal_business_name: 'Benny\'s Deli',
    dba_business_name: 'Benny\'s',
    business_type: 'partnership',
    date_established: '2020-01-01',
    phone: '+12345678989',
    website: 'www.bennys.com'
  })
};

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"

payload = {
    "addresses": [{
            "address_type": "MAILING",
            "street": "345 California Ave.",
            "street2": "Suit 600",
            "city": "San Francisco",
            "state": "CA",
            "zip_code": "12345-1234",
            "country": "US",
            "is_primary": True
        }, {}],
    "beneficial_owners": [
        {
            "addresses": [
                {
                    "address_type": "PHYSICAL",
                    "street": "345 California Ave.",
                    "street2": "Suit 600",
                    "city": "San Francisco",
                    "state": "CA",
                    "zip_code": "12345-1234",
                    "country": "US",
                    "is_primary": True
                }
            ],
            "dob": "1992-12-12T00:00:00.000Z",
            "first_name": "John",
            "last_name": "Deere"
        }
    ],
    "ein": "12-1234567",
    "legal_business_name": "Circle Enterprises",
    "dba_business_name": "Circle Enterprises",
    "business_type": "limited_liability_company",
    "date_established": "2020-01-01T00:00:00.000Z",
    "phone": "12345678777",
    "email": "[email protected]",
    "website": "www.CircleEnterprises.com"
}
headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
    "Identity": "de8860e3-5af8-455a-9034-bbd4072d23d4"
}

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

print(response.text)

var client = new RestClient("https://sandbox.bond.tech/api/v0/businesses");
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Identity", "<YOUR_IDENTITY>");
request.AddHeader("Authorization", "<YOUR_AUTHORIZATION>");
request.AddParameter("application/json", "{\"addresses\":[{\"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\":[{\"dob\":\"1992-12-12\",\"first_name\":\"John\",\"last_name\":\"Pasakovitch\",\"addresses\":[{\"address_type\":\"PHYSICAL\",\"street\":\"345 California Ave.\",\"street2\":\"Suit 600\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip_code\":\"12345-1234\",\"country\":\"US\",\"is_primary\":true}]}],\"ein\":\"12-1234588\",\"legal_business_name\":\"Benny's Deli\",\"dba_business_name\":\"Benny's\",\"business_type\":\"partnership\",\"date_established\":\"2020-01-01\",\"phone\":\"+12345678989\",\"website\":\"www.bennys.com\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"addresses\":[{\"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\":[{\"dob\":\"1992-12-12\",\"first_name\":\"John\",\"last_name\":\"Pasakovitch\",\"addresses\":[{\"address_type\":\"PHYSICAL\",\"street\":\"345 California Ave.\",\"street2\":\"Suit 600\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip_code\":\"12345-1234\",\"country\":\"US\",\"is_primary\":true}]}],\"ein\":\"12-1234588\",\"legal_business_name\":\"Benny's Deli\",\"dba_business_name\":\"Benny's\",\"business_type\":\"partnership\",\"date_established\":\"2020-01-01\",\"phone\":\"+12345678989\",\"website\":\"www.bennys.com\"}");
Request request = new Request.Builder()
  .url("https://sandbox.bond.tech/api/v0/businesses")
  .post(body)
  .addHeader("Content-Type", "application/json")
  .addHeader("Identity", "<YOUR_IDENTITY>")
  .addHeader("Authorization", "<YOUR_AUTHORIZATION>")
  .build();

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

Example response

The JSON response contains all the information related to the newly created business. It also returns the new business_id which is a unique identifier for the business. The business_id is used in subsequent API calls to retrieve and update the business resource, initiate KYB, and issue cards.

The following is an example of a successful business creation response.

{
    "addresses": [
        {
            "address_id": "f36734ce-e8a2-43fa-a6d5-6a15f31ccea1",
            "address_type": "MAILING",
            "city": "San Francisco",
            "country": "US",
            "date_created": "2025-04-24T17:44:18.523517+00:00",
            "is_primary": false,
            "state": "CA",
            "street": "100 California Ave.",
            "street2": "Suit 600",
            "zip_code": "12345-1234"
        },
        {
            "address_id": "27904e4d-a313-4ebf-8d54-05fb153c1e4f",
            "address_type": "PHYSICAL",
            "city": "San Francisco",
            "country": "US",
            "date_created": "2025-04-24T17:44:18.523526+00:00",
            "is_primary": true,
            "state": "CA",
            "street": "200 California Ave.",
            "street2": "Suit 100",
            "zip_code": "12345-1234"
        }
    ],
    "beneficial_owners": [
        {
            "addresses": [
                {
                    "address_id": "139d7c67-4847-4414-9933-df85696c9120",
                    "address_type": "MAILING",
                    "city": "San Francisco",
                    "country": "US",
                    "date_created": "2025-04-24T17:44:18.537079+00:00",
                    "is_primary": true,
                    "state": "CA",
                    "street": "100 California Ave.",
                    "street2": "Suit 600",
                    "zip_code": "12345-1234"
                }
            ],
            "beneficial_owner_id": "dd5e2082-4871-4854-9de9-e8b5b82721c8",
            "date_created": "2025-04-24T17:44:18.511234+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": "ad7d8620-bd2f-4f09-86fb-fe4e4544f903",
                    "address_type": "MAILING",
                    "city": "San Francisco",
                    "country": "US",
                    "date_created": "2025-04-24T17:44:18.537088+00:00",
                    "is_primary": true,
                    "state": "CA",
                    "street": "200 California Ave.",
                    "street2": "Suit 600",
                    "zip_code": "12345-1234"
                }
            ],
            "beneficial_owner_id": "3702c942-0dd4-4a62-9d18-3eed82d2f0cd",
            "date_created": "2025-04-24T17:44:18.511251+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": "9201b533-4601-4e8d-923e-bd053e0c1a59",
    "business_type": "limited_liability_company",
    "date_created": "2025-04-24T17:44:18.505583+00:00",
    "date_established": null,
    "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"
}

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

When missing a field

If you try to create a business with a missing field, you receive a JSON response similar to the following example.

{
'Message': {'legal_business_name': ['Missing data for required field.']},
 'Status': 400,
 'Code': 'create_business_schema',
 'Type': 'Request Error'
}

business object