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.
Company registration numbers (businessInformation.registrationNumber and registrationNumberType) are stored and verified separately from the tax ID. Do not submit a VAT or tax number as the registration number. See EEA+ businesses for accepted registration number types.

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:
br_digital_drivers and br_digital_id are accepted only with country: "BRA". They are single-sided: upload one image and omit the side field. These types cover Brazilian digital documents (CNH digital, RG digital). Physical Brazilian documents continue to use drivers and id_card with front and back.
Supporting (non-ID) documents use the same field: liveness_report_document (liveness/face verification, individuals and business representatives), proof_of_address_document (business representatives), and the business-customer documents incorporation_cert_document, shareholder_registry_document, and proof_of_address_document. 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 August 24, 2026