Get KYC Required Documents

Get required document types for KYC

GET

texttext

/api/v2/kyc/required-documents

Returns the list of acceptable document types for KYC verification, filtered by country and level.

Query Parameters

countryCodestringrequired

ISO country code

kycLevelstring

Target KYC level

Response Schema

documentsarray

Array of document type objects

documents[].typestring

Document type identifier

documents[].namestring

Display name

documents[].requiredboolean

Whether this is mandatory

documents[].formatstring

Accepted formats (IMAGE, PDF)

documents[].maxSizeMBnumber

Maximum file size in MB

Example

jsonjson

GET /api/v2/kyc/required-documents?countryCode=US&kycLevel=TIER_2
// Response:
{
  "documents": [
    { "type": "GOVERNMENT_ID", "name": "Government Issued ID", "required": true, "format": ["IMAGE","PDF"], "maxSizeMB": 5 },
    { "type": "SELFIE", "name": "Selfie Photo", "required": true, "format": ["IMAGE"], "maxSizeMB": 3 },
    { "type": "PROOF_OF_ADDRESS", "name": "Proof of Address", "required": false, "format": ["IMAGE","PDF"], "maxSizeMB": 5 }
  ]
}