Skip to main content
POST
Scan Document
Submit a single image of a government-issued ID. The response contains the extracted text fields (name, date of birth, document number, address, expiry, etc.), a normalized documentType, and an average extraction confidence score.

Request

Headers

Body parameters

The endpoint accepts the image either as raw multipart bytes or as a JSON string (base64, base64url, or an S3 key from an earlier presigned upload). See the overview for the shared image rules — accepted formats, the 15 MB limit, and when to prefer one over the other.

Example request

Response

200 — Success

Error responses

When to use /v1/identity/verify instead

If you also have a selfie and want a single round-trip that runs document scan + face detect + face compare in parallel, call /v1/identity/verify instead — it returns one aggregated payload with an overallConfidence score.