Supported Identity Document Types

This document outlines the accepted identity document types for different countries, including specific requirements for document images.

Applicability: This documentation applies exclusively to:

• Individual Senders
• Ultimate Beneficial Owners (UBOs) of Business Senders

⚠️

Always fetch supported document types from the API

The static tables below are provided for reference only and may drift over time. The authoritative, per-country list of supported identity document types is served by the V2 Validation Rules endpoints. Integrations should query these at runtime rather than hardcoding the tables.

Source-of-Truth API Endpoints

Supported identity document types are returned under the identity field's documentType.supportedDocumentTypes array in the V2 validation-rules response.

Individual Senders

GET /v2/validation-rules/senders

Reference: Get Sender Validation Rules (V2)

UBOs of Business Senders

GET /v2/validation-rules/senders/ubo

Reference: Get UBO Validation Rules (V2)

Response Shape

Each entry in supportedDocumentTypes has the following fields:

Example (trimmed) response fragment:

{
  "data": {
    "rules": {
      "ubo": {
        "requiredFields": [
          {
            "field": "identity",
            "nestedFields": [
              {
                "field": "documentType",
                "supportedDocumentTypes": [
                  { "type": "NATIONAL_ID", "category": "ID_NUMBER",   "requiresFront": false, "requiresBack": false },
                  { "type": "PASSPORT",    "category": "ID_DOCUMENT", "requiresFront": true,  "requiresBack": false },
                  { "type": "ID_CARD",     "category": "ID_DOCUMENT", "requiresFront": true,  "requiresBack": true  }
                ]
              }
            ]
          }
        ]
      }
    }
  }
}

How to interpret the response:

• category: ID_NUMBER → send only the document number. No file upload required.
• category: ID_DOCUMENT → upload documentFront (and documentBack if requiresBack is true).
• Only one document type from the returned list needs to be provided per sender/UBO.

Reference Snapshot

The tables below are a point-in-time snapshot generated from the UBO identity configuration and are for quick reference only. Always verify against the V2 API response for the given country.

Group A: Countries Supporting ID_NUMBER Document Types (No Images Required)

These countries accept one or more ID_NUMBER-category document types that can be submitted with only the document number (no file upload). The same country may also support ID_DOCUMENT-category types as alternatives (images required) — both columns are shown below.

Group B: Countries Supporting Only ID_DOCUMENT Types (Images Required)

These countries do not currently support any ID_NUMBER-category types. Every supported document type is in the ID_DOCUMENT category and requires file uploads (documentFront, plus documentBack when the type's requiresBack flag is true).

Important Notes:

1. For all ID_DOCUMENT-category types, documentFront is required; documentBack is required when the type's requiresBack flag is true.
2. Only one document type from the returned list needs to be provided per sender/UBO.
3. Document images must be clear, legible, and show all corners of the document.
4. Images must be in an acceptable format (JPG, PNG) and meet size requirements.
5. Per-type requiresFront / requiresBack flags in the V2 API response are authoritative — always use them as the source of truth.

Legal Notice

This documentation is for reference purposes only. Document requirements may change based on regulatory updates or policy changes. Always verify current requirements through the V2 validation-rules API or official channels.