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 Country
country
Business's or owner's address country 3 chars
(ISO 3166)
USA
Address Postal Code
postal_code
Business's or owner's address postal code 5 or 9 digits 94105
94105-3907
Address Region
region
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 Type
business_type
Sellers's incorporated business type Enum CORPORATION
Owner Email
email
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 Country
country
Business's or owner's address country 3 chars
(ISO 3166)
CAN
Address Postal Code
postal_code
Business's or owner's address postal code 6 chars
plus space
A1A 2B2
Address Region
region
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 Type
business_type
Sellers's incorporated business type Enum CORPORATION
Owner Email
email
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