Call the Add Business endpoint.

To ensure strong matches and maximize data returned by downstream KYB and KYC endpoints, include all required fields and as many recommended fields as are available during onboarding. The more context you provide, the more accurately we can verify and return business information—minimizing manual entry for the end user.

Required/Recommended fields for KYB:

Field NameRequired / RecommendedNotes
name✅ RequiredLegal business name
external_id✅ RequiredInternal identifier for tracking
tin (Tax ID)🔶 RecommendedStrongest match for business identity
address_line_1🔶 RecommendedBusiness street address
address_city🔶 RecommendedCity of the business
address_state🔶 RecommendedState where business operates
address_postal_code🔶 RecommendedZIP/Postal code
naics_code or mcc_code🔶 RecommendedIndustry classification business code
year_created🔶 RecommendedThe year the company was created
annual_total_income🔶 RecommendedBusiness revenue
official_website🔶 RecommendedCompany website

Required/Recommended fields for KYC

Field NameRequired / RecommendedNotes
owner1_first_name🔶 RecommendedIndividual’s legal first name
owner1_last_name🔶 RecommendedIndividual’s legal last name
owner1_mobile🔶 RecommendedPersonal contact number
owner1_email🔶 RecommendedPrimary email address
owner1_dob🔶 RecommendedUsed for identity matching (encrypted)
owner1_ssn🔶 RecommendedEncrypted — critical for verification
owner1_address_line_1🔶 RecommendedHome street address
owner1_address_line_2🔶 RecommendedApartment / Suite / Unit
owner1_address_city🔶 RecommendedResidential city
owner1_address_state🔶 RecommendedResidential state
owner1_address_postal🔶 RecommendedZIP code of the residential address
owner1_title✅ Required

Insert one of the following strings: Partner, Limited Partner, Director, Chief Accounting Officer, Chief Executive Officer, Chief Operations Officer, President, Vice President, Treasurer, Assistant Treasurer, 1% Shareholder, Shareholder, Controller, Managing Member, Owner, Sole Proprietor, Executor, Beneficiary, Trustee, Administrator

owner1_owner_type✅ RequiredInsert one of the following strings: “Control” or “Beneficial owner”