Skip to main content
When onboarding customers, the Customers API and Documents API accept a fixed set of identity document types and country-specific tax identification number types. This page is the reference for both.
These values feed identity verification (KYC/KYB). The accepted tax ID type depends on the customer’s country of residence (or country of incorporation, for businesses). When a country is not listed, any tax ID type is accepted as a fallback.

Identity document types

Government-issued ID documents are uploaded via POST /v2/document using the documentType field. Accepted ID document types depend on the upload target: Supporting (non-ID) documents use the same field: liveness_report (liveness/face verification, individuals and business representatives), proof_of_address (business representatives), and the business-customer documents incorporation_cert, shareholder_registry, and proof_of_address. See the Upload a document reference for the full per-target list.
Accepted ID document types can be further restricted by the issuing country. Always send the issuing-country ISO 3166-1 alpha-3 code in the country field; if a document type is not enabled for that country, the upload is rejected.

Tax identification number types

When you provide tax identification details on a customer, all of number, type, and country are required together. The type is one of the codes below; which codes are valid depends on the country.
  • Individual customerspersonalInformation.taxIdentification.type (e.g. "ssn", "cpf").
  • Business customers — the business tax ID type for the country of incorporation (e.g. "ein", "cnpj").
United States: the individual tax ID type is always treated as ssn and a tax identification number is required. Other countries: if the country is not in the tables below, any tax ID type string is accepted (allowAnyTaxIdType fallback).

Common examples

Tax ID type glossary

Full names for every tax ID type code referenced in the tables on this page.

Full country reference

Last modified on June 16, 2026