v1

latestOpenAPI 3.0.02026-07-2468247202.3 KB

KYB > Profile Management

Create Business Profile

Create a business profile that you would like to track over time. You can run verifications against this business any number of times in the future. Use this endpoint and add officers to also KYC the officers.

post/verify/create_business_profile

Request body

namestring

The business name. (Legal name preferred)

alternate_namestring

Alternate business name. (DBA)

tax_identification_numberstring

Tax ID

websitestring

The business website

formation_datestring

The formation date in YYYY-MM-DD format

country_codestring

A 2-letter ISO country code where business is primarily registered.

state_codestring

State Code of the province/region where business is primarily registered.

business_entity_idstring

Entity ID given by the government to the business.

phone_numbersstring[]

List of phone numbers associated with this business

email_addressesstring[]

List of email addresses associated with this business

client_reference_idstring

An id you want to associate with the business profile.

client_reference_dataobject

A JSON you want to associate with the business profile.

callback_urlstring

events_callback_urlstring

tagsstring[]

List of tag names associated with this business profile

Example request

{
  "name": "AiPrise",
  "alternate_name": "AiPrise Inc",
  "website": "www.aiprise.com",
  "formation_date": "1999-03-21",
  "country_code": "US",
  "addresses": [
    {
      "address_street_1": "222 Palm Street",
      "address_city": "Santa Monica",
      "address_state": "CA",
      "address_zip_code": "93251",
      "address_country": "US"
    }
  ],
  "phone_numbers": [
    "+13334445555"
  ],
  "client_reference_id": "b79160f1-3ea5-4bf0-be43-43c4a2cf8810",
  "callback_url": "https://yourwebsite.com/aiprise-callback",
  "events_callback_url": "https://yourwebsite.com/aiprise-callback"
}

Response

Successful operation

business_profile_idstring