v1

latestOpenAPI 3.0.02026-07-247150151.6 KB
Businesses

Create a business

Creates a business associated with a brand

post/businesses

Request body

brand_business_idstring

The brand's UUID for the business.

einstring

The Tax Identification Number

legal_business_namestring required

The legal business name

dba_business_namestring

The doing-business-as name (trade name)

business_type'cooperative' | 'limited_liability_company' | 'sole_proprietorship' | 'partnership' | 'limited_partnership' | 'corporation' | 'nonprofit_organization'

The business type

date_establishedstring string

Date of incorporation in YYYY-MM-DD format

phonestring

Phone number

emailstring

Business contact email

websitestring

The official website

industry_typestring

Type of business conducted

number_of_employeesstring

Description of number of employees at firm, as a range or value

Example request

{
  "brand_business_id": "ac6ee2d3-5a03-4043-a4aa-dda51836b9fd",
  "ein": "12-1234567",
  "legal_business_name": "John Doe Business Corporation",
  "dba_business_name": "John's",
  "business_type": "cooperative",
  "date_established": "2020-01-01T00:00:00.000Z",
  "phone": "+14157485052",
  "email": "info@business.com",
  "website": "www.business.com",
  "industry_type": "Financial",
  "number_of_employees": "0-50",
  "addresses": [
    {
      "street": "345 California Ave.",
      "street2": "Suit 600",
      "city": "San Francisco",
      "state": "CA",
      "zip_code": "12345-1234",
      "country": "US",
      "is_primary": true
    }
  ],
  "beneficial_owners": [
    {
      "dob": "1980-04-04",
      "first_name": "John",
      "middle_name": "O'Shea",
      "last_name": "Doe",
      "addresses": [
        {
          "street": "345 California Ave.",
          "street2": "Suit 600",
          "city": "San Francisco",
          "state": "CA",
          "zip_code": "12345-1234",
          "country": "US",
          "is_primary": true
        }
      ]
    }
  ]
}

Response

Example response

business_idstring required
brand_business_idstring required
einstring required
phonestring required
emailstring required
websitestring required
legal_business_namestring required
dba_business_namestring required
business_typestring required
industry_typestring required
number_of_employeesstring required