Creating a business

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
required

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.

addresses
required

Array

One or more official addresses that includes:
address_type, street, city, state, zip_code, country, is_primary

street_2 (not required)

beneficial_owners

Array

One or more Beneficial Owners, for each of which include:
dob, first_name, last_name, addresses

middle_name (not required)

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

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

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/customers/"

payload = {
  "ein": "12-1234567",
  "phone": "+14085557788",
  "email": "[email protected]",
  "website": "https://www.specter.com",
  "legal_business_name": "Specter and Sons Inc.",
  "dba_business_name": "Specter\'s",
  "business_type": "Sole Proprietorship",
  "addresses": [
    {
      "address_type": "PHYSICAL",
      "street": "345 California St.",
      "street2": "Suit 600",
      "city": "San Francisco",
      "state": "CA",
      "zip_code": "94104-2657",
      "country": "US",
      "is_primary": True
    }
  ],
  "beneficial_owners": [
    {
      "first_name": "James",
      "last_name": "Bond",
      "dob": "1992-10-10",
      "addresses": [
        {
          "address_type": "PHYSICAL",
          "street": "345 James Bond St.",
          "street2": "Suit 600",
          "city": "San Francisco",
          "state": "CA",
          "zip_code": "94104-2657",
          "country": "US",
          "is_primary":True
        }
      ]
    }
  ]
}

headers = {
  "Content-Type": "application/json",
  "Identity": YOUR-IDENTITY,
  "Authorization": YOUR-AUTHORIZATION
}

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();

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 Studio 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 successful business creation response is shown below.

{
   "date_created":"2021-05-18T10:05:13.176818-07:00",
   "business_id":"1e847b10-b7e7-4978-a0a2-fed9d44c2e91",
   "ein":"12-1234567",
   "legal_business_name":"Specter and Sons Inc.",
   "dba_business_name":"Specter's",
   "business_type":"Sole Proprietorship",
   "date_established":"None",
   "phone":"+14085557788",
   "email":"[email protected]",
   "website":"https://www.specter.com",
   "addresses":[
      {
         "date_created":"2021-05-18T10:05:13.220764-07:00",
         "address_id":"d3dda856-ada3-44b2-8323-1283f1624777",
         "address_type":"PHYSICAL",
         "street":"345 California St.",
         "street2":"Suit 600",
         "city":"San Francisco",
         "state":"CA",
         "zip_code":"94104-2657",
         "country":"US",
         "is_primary":true,
         "deliverability":"undeliverable"
      },
      {
         "date_created":"2021-05-18T10:05:13.257231-07:00",
         "address_id":"cb27d8cd-c25e-42f3-b96f-d0bc0309c31d",
         "address_type":"MAILING",
         "street":"345 California St.",
         "street2":"Suit 100",
         "city":"San Francisco",
         "state":"CA",
         "zip_code":"94104-2657",
         "country":"US",
         "is_primary":false,
         "deliverability":"deliverable"
      }
   ],
   "beneficial_owners":[
      {
         "date_created":"2021-05-18T10:05:13.258302-07:00",
         "beneficial_owner_id":"8ac8337c-b483-40cf-839a-010cb2426bbb",
         "first_name":"James",
         "middle_name":"None",
         "last_name":"Bond",
         "addresses":[
            {
               "date_created":"2021-05-18T10:05:13.266644-07:00",
               "address_id":"1be55599-69d6-4a19-9353-9c2e9166bc26",
               "address_type":"PHYSICAL",
               "street":"345 James Bond St.",
               "street2":"Suit 600",
               "city":"San Francisco",
               "state":"CA",
               "zip_code":"94104-2657",
               "country":"US",
               "is_primary":true,
               "deliverability":"deliverable"
            }
         ],
      },
      {
         "date_created":"2021-05-18T10:05:13.265486-07:00",
         "beneficial_owner_id":"ad24741a-2392-4bc3-bce4-0b817ed2ed9e",
         "first_name":"Auric",
         "middle_name":"None",
         "last_name":"Goldfinger",
         "addresses":[
            {
               "date_created":"2021-05-18T10:05:13.276026-07:00",
               "address_id":"468b687f-8530-4255-bd3d-68a960608a63",
               "address_type":"PHYSICAL",
               "street":"345 Auric St.",
               "street2":"Suit 600",
               "city":"San Francisco",
               "state":"CA",
               "zip_code":"94104-2657",
               "country":"US",
               "is_primary":true,
               "deliverability":"deliverable"
            }
         ],
      }
   ],
}

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?