Creating a business

How to create a business and add its details to the system.

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

▶ Run in Postman

Parameter

Type

Description

ein

string

Unique type of tax identification number used to identify the business with the IRS.

legal_business_name
required

string

Freeform, alphanumeric, legal name of the business.

dba_business_name

string

Freeform, alphanumeric, "doing-business-as" name (trade name).

business_type

string

Select one of: cooperative, limited_liability_company, sole_proprietorship, partnership, limited_partnership, corporation, nonprofit_organization

date_established

date

Date of incorporation in YYYY-MM-DD format, for example 2021-06-28

phone

string

Freeform number with or without hyphens, for example 01-324-5556684

email

string

Business contact email of the form [email protected]

website

string

The official website of the form www.goldfinger.com

addresses
required

array

Array of one or more physical or mailing addresses (see addresses Object table below).

beneficial_owners

array

Array of one or more beneficial owners (see beneficial_owners Object table below).

The addresses array within the Business object has the following structure.

address Object

Type

Description

address_type
required

string

Either MAILING or PHYSICAL.

street
required

string

Freeform name between 1 and 40 characters. May contain only alphanumeric and these special characters . , _ - #

street2

string

Freeform name maximum 40 characters.

city
required

string

City name, freeform between 2 and 40 characters.

state
required

string

Two-character US state code. Non-US state code maximum 20 characters.

zip_code
required

string

Five-digit US zip code, (for example 12345) or nine-digit US zip code, (for example 12345-1234).
Non-US state code between 2 and 20 characters.

country
required

string

ISO 3166-1 alpha-2 country code, maximum two characters.

is_primary
required

boolean

Is this the primary address; either true or false.

The beneficial_owners array within the Business object has the following structure.

Beneficial Owners Object

Type (* Required)

Description

dob
required

string

Date of birth in YYYY-MM-DD format, for example 1978-06-20.

first_name
required

string

First name, between 1 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.

last_name
required

string

Last name, between 2 and 20 characters. Must start with a letter and can only contain letters, spaces, and apostrophes.

addresses
partially required

array

One or more official addresses, see Addresses array table above.

An example of a request to create a business resource is shown below.

curl --request POST \
     --url https://sandbox.bond.tech/api/v0.1/businesses \
     --header 'Accept: application/json' \
     --header 'Authorization: YOUR-AUTHENTICATION' \
     --header 'Content-Type: application/json' \
     --header 'Identity: YOUR-IDENTITY' \
     --data @- <<EOF
{
     "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
          }
     ],
     "ein": "12-1234567",
     "legal_business_name": "John Doe Business Corporation",
     "dba_business_name": "John's",
     "business_type": "limited_liability_company",
     "date_established": "2020-01-01T00:00:00.000Z",
     "phone": "12345678989",
     "email": "[email protected]",
     "website": "www.business.com"
}
EOF
require 'uri'
require 'net/http'
require 'openssl'

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

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

request = Net::HTTP::Post.new(url)
request["Accept"] = 'application/json'
request["Content-Type"] = 'application/json'
request["Identity"] = 'YOUR-IDENTITY'
request["Authorization"] = 'YOUR-AUTHENTICATION'
request.body = "{\"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}],\"ein\":\"12-1234567\",\"legal_business_name\":\"John Doe Business Corporation\",\"dba_business_name\":\"John's\",\"business_type\":\"limited_liability_company\",\"date_established\":\"2020-01-01T00:00:00.000Z\",\"phone\":\"12345678989\",\"email\":\"[email protected]\",\"website\":\"www.business.com\"}"

response = http.request(request)
puts response.read_body
const options = {
  method: 'POST',
  headers: {
    Accept: 'application/json',
    'Content-Type': 'application/json',
    Identity: 'YOUR-IDENTITY',
    Authorization: 'YOUR-AUTHENTICATION'
  },
  body: JSON.stringify({
    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
      }
    ],
    ein: '12-1234567',
    legal_business_name: 'John Doe Business Corporation',
    dba_business_name: 'John\'s',
    business_type: 'limited_liability_company',
    date_established: '2020-01-01T00:00:00.000Z',
    phone: '12345678989',
    email: '[email protected]',
    website: 'www.business.com'
  })
};

fetch('https://sandbox.bond.tech/api/v0.1/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.1/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
        }
    ],
    "ein": "12-1234567",
    "legal_business_name": "John Doe Business Corporation",
    "dba_business_name": "John's",
    "business_type": "limited_liability_company",
    "date_established": "2020-01-01T00:00:00.000Z",
    "phone": "12345678989",
    "email": "[email protected]",
    "website": "www.business.com"
}
headers = {
    "Accept": "application/json",
    "Content-Type": "application/json",
    "Identity": "YOUR-IDENTITY",
    "Authorization": "YOUR-AUTHENTICATION"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
var client = new RestClient("https://sandbox.bond.tech/api/v0.1/businesses");
var request = new RestRequest(Method.POST);
request.AddHeader("Accept", "application/json");
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Identity", "YOUR-IDENTITY");
request.AddHeader("Authorization", "YOUR-AUTHENTICATION");
request.AddParameter("application/json", "{\"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}],\"ein\":\"12-1234567\",\"legal_business_name\":\"John Doe Business Corporation\",\"dba_business_name\":\"John's\",\"business_type\":\"limited_liability_company\",\"date_established\":\"2020-01-01T00:00:00.000Z\",\"phone\":\"12345678989\",\"email\":\"[email protected]\",\"website\":\"www.business.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\":\"MAILING\",\"street\":\"345 California Ave.\",\"street2\":\"Suit 600\",\"city\":\"San Francisco\",\"state\":\"CA\",\"zip_code\":\"12345-1234\",\"country\":\"US\",\"is_primary\":true}],\"ein\":\"12-1234567\",\"legal_business_name\":\"John Doe Business Corporation\",\"dba_business_name\":\"John's\",\"business_type\":\"limited_liability_company\",\"date_established\":\"2020-01-01T00:00:00.000Z\",\"phone\":\"12345678989\",\"email\":\"[email protected]\",\"website\":\"www.business.com\"}");
Request request = new Request.Builder()
  .url("https://sandbox.bond.tech/api/v0.1/businesses")
  .post(body)
  .addHeader("Accept", "application/json")
  .addHeader("Content-Type", "application/json")
  .addHeader("Identity", "YOUR-IDENTITY")
  .addHeader("Authorization", "YOUR-AUTHENTICATION")
  .build();

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

The JSON response contains all the information related to the newly created business. It also returns the new business_id which is a unique Bond 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.

An example of a response to a successful business creation request is shown below.

{
  "ein": "12-1234567",
  "phone": "+14085557788",
  "email": "[email protected]",
  "website": "https://www.specter.com",
  "legal_business_name": "World Domination Inc.",
  "dba_business_name": "World Domination Inc.",
  "business_type": "limited_liability_company",
  "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
    },
    {
      "address_type": "PHYSICAL",
      "street": "123 California Ave.",
      "street2": "Suit 100",
      "city": "San Francisco",
      "state": "CA",
      "zip_code": "12345-1234",
      "country": "US",
      "is_primary": false
    }
  ],
  "beneficial_owners": [
    {
      "first_name": "James",
      "last_name": "Bond",
      "dob": "1970-12-12",
      "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
        }
      ]
    },
    {
      "first_name": "Le",
      "last_name": "Chiffre",
      "dob": "1980-04-04",
      "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
        }
      ]
    }
  ]
}

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

Trying to creating a business with a missing field

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

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

Did this page help you?