Skip to content
Logo

IdentifyingInformation

Government-issued IDs and tax identifiers. Used on individual customers, business customers, and each AssociatedPerson on a business.

FieldTypeRequiredNotes
typeenum: drivers_license, national_id, passport, + 60+ tax-id types (ssn, itin, nino, rfc, …)yesGovernment IDs and tax identifiers share this array.
issuing_countrystring (ISO 3166-1 alpha-3)yes
numberstringconditionalRequired for government IDs. Optional for some tax-id types.
descriptionstringconditionalRequired when type === "other".
expirationstring (YYYY-MM-DD)no
image_frontstring (base64 data-uri)noMin 200×200px, max 15 MB (combined with back: 24 MB).
image_backstring (base64 data-uri)no

Example: US SSN

{
  "type": "ssn",
  "issuing_country": "USA",
  "number": "111-22-3333"
}

Example: passport with image

{
  "type": "passport",
  "issuing_country": "USA",
  "number": "A12345678",
  "expiration": "2032-06-01",
  "image_front": "data:image/jpeg;base64,…"
}