Data Formats by Country
Learn how to pass in data for each country.
Upcoming API Updates – August 2024
This guide reflects the updated validation we will apply to these Identity
fields:business_address.postal_code
, business_address.region
, business_phone
, business_tax_id
, email
, personal_address.postal_code
, personal_address.region
, and phone
United States
Field | Description | Format | Example(s) |
---|---|---|---|
Address Countrycountry |
Business's or owner's address country | 3 chars (ISO 3166) |
USA |
Address Postal Codepostal_code |
Business's or owner's address postal code | 5 or 9 digits | 94105 94105-3907 |
Address Regionregion |
Business's or owner's address state | 2 chars | CA |
Bank Account Number account_number |
Bank account number | 5-17 digits | 1001001234 |
Bank Routing Number bank_code |
Bank routing number | 9 digits | 026009593 |
Business Phone business_phone |
Business's phone number | Valid phone number | 12124567890 +1 (212) 456-7890 |
Business Tax ID business_tax_id |
Employer Identification Number (EIN) | 9 digits | 283748298 |
Business Typebusiness_type |
Sellers's incorporated business type | Enum | CORPORATION |
Owner Emailemail |
Owner's email address | Valid email address | johndoe@gmail.com |
Owner Phone phone |
Owner's phone number | Valid phone number | 12124567890 +1 (212) 456-7890 |
Owner Tax ID tax_id |
Social Security Number (SSN) or Individual Taxpayer Identification Number (ITIN) |
9 digits | 283748298 |
Individual Sole Proprietorships
Field | Description | Format | Example(s) |
---|---|---|---|
Business Name business_name |
Owner's full legal name | String | John Doe |
Business Tax ID business_tax_id |
Employer Identification Number (EIN) or Null |
9 digits | 283748298 null |
Canada
Field | Description | Format | Example(s) |
---|---|---|---|
Address Countrycountry |
Business's or owner's address country | 3 chars (ISO 3166) |
CAN |
Address Postal Codepostal_code |
Business's or owner's address postal code | 6 chars plus space |
A1A 2B2 |
Address Regionregion |
Business's or owner's address province / territory | 2 chars | ON |
Bank Account Number account_number |
Bank account number | 5-17 digits | 1001001234 |
Bank Institution Number institution_number |
Bank institution number | 3 digits | 177 |
Bank Transit Number transit_number |
Bank transit number | 5 digits | 00006 |
Business Phone business_phone |
Business's phone number | Valid phone number | 12124567890 +1 (212) 456-7890 |
Business Tax ID business_tax_id |
Business Number (BN) | 9 digits | 283748298 |
Business Typebusiness_type |
Sellers's incorporated business type | Enum | CORPORATION |
Owner Emailemail |
Owner's email address | String | johndoe@gmail.com |
Owner Phone phone |
Owner's phone number | Valid phone number | 12124567890 +1 (212) 456-7890 |
Owner Tax ID tax_id |
(Optional) Social Insurance Number (SIN) | 9 digits | 283748298 null |
Individual Sole Proprietorships
Field | Description | Format | Example(s) |
---|---|---|---|
Business Name business_name |
Owner's full legal name | String | John Doe |
Business Tax ID business_tax_id |
Business Number (BN) or Null |
9 digits | 283748298 null |
Trusts
Field | Description | Format | Example(s) |
---|---|---|---|
Business Tax ID business_tax_id |
Business Number (BN) or Trust Account Number |
9 digits T+8 digits |
283748298 T83748298 |