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 digits	`94105`
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`
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`
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`
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`
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`