Skip to content

Deel: Submit external KYC — request body — body data kyc document

Submit external KYC: request body, field body / data / kyc_document. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Submit external KYC — request body — body data kyc document

FieldTypePresenceDescription and constraints
$objectRoot
document_namestringOptionalName of the document when type is ‘other’
Maximum length: 100
expiration_datestringOptionalExpiry date of the document (YYYY-MM-DD)
Format: date
id_numberstringRequired within parentDocument identification number
Maximum length: 50
issuance_countrystringRequired within parentCountry where the document was issued (ISO 3166‑1 alpha‑2)
Maximum length: 2
Minimum length: 2
issuance_datestringOptionalDate when the document was issued (YYYY-MM-DD)
Format: date
typestringRequired within parentType of KYC document (e.g., passport, driver’s license)
One of: passport, driving_license, government_id, other

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.