Developers

Retrieve the OCR result

Processing is asynchronous. Poll the document until it leaves the processing state.

Fetch a document

curl https://api.mahadocr.com/v1/documents/DOC_831d6b45e154 \
  -H "X-MahadDoc-API-Key: mk_live_YOUR_KEY"

Status values

processing — still being read
verified — every required field confirmed by evidence
review — at least one field disputed, unreadable or missing; a person checks it
failed — the document could not be read

Response shape

{
  "status": "verified",
  "result": {
    "decision": "verified",
    "document_type": "passport",
    "values": { "surname": "ERIKSSON", "given_names": "ANNA MARIA", "document_number": "L898902C3", "date_of_birth": "1974-08-12", "expiry_date": "2027-04-15" },
    "field_evidence": { "surname": "corroborated", "document_number": "deterministic", "date_of_birth": "deterministic" },
    "review_reasons": []
  }
}