Pre-filling Data
Step 2 - Add Business
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 Name | Required / Recommended | Notes |
---|---|---|
name | ✅ Required | Legal business name |
external_id | ✅ Required | Internal identifier for tracking |
tin (Tax ID) | 🔶 Recommended | Strongest match for business identity |
address_line_1 | 🔶 Recommended | Business street address |
address_city | 🔶 Recommended | City of the business |
address_state | 🔶 Recommended | State where business operates |
address_postal_code | 🔶 Recommended | ZIP/Postal code |
naics_code or mcc_code | 🔶 Recommended | Industry classification business code |
year_created | 🔶 Recommended | The year the company was created |
annual_total_income | 🔶 Recommended | Business revenue |
official_website | 🔶 Recommended | Company website |
Required/Recommended fields for KYC
Field Name | Required / Recommended | Notes |
---|---|---|
owner1_first_name | 🔶 Recommended | Individual’s legal first name |
owner1_last_name | 🔶 Recommended | Individual’s legal last name |
owner1_mobile | 🔶 Recommended | Personal contact number |
owner1_email | 🔶 Recommended | Primary email address |
owner1_dob | 🔶 Recommended | Used for identity matching (encrypted) |
owner1_ssn | 🔶 Recommended | Encrypted — critical for verification |
owner1_address_line_1 | 🔶 Recommended | Home street address |
owner1_address_line_2 | 🔶 Recommended | Apartment / Suite / Unit |
owner1_address_city | 🔶 Recommended | Residential city |
owner1_address_state | 🔶 Recommended | Residential state |
owner1_address_postal | 🔶 Recommended | ZIP 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 | ✅ Required | Insert one of the following strings: “Control” or “Beneficial owner” |