Skip to main content
Several endpoints (voter ID OCR, proof of address, face match, liveness, CSF extraction with PDF) accept images. Send them as base64-encoded strings in the relevant field.

Format

Send the raw base64 string only. Do not include the data:image/...;base64, prefix.

Limits

Requests that exceed these limits are rejected with INVALID_REQUEST and errors[].code = "PAYLOAD_TOO_LARGE". The field points either to the specific image field that exceeds 12 MB, or to body when the whole request exceeds 28 MB. Multi-image endpoints (e.g. voter ID OCR with front + back, face match with face + front) share the 28 MB body cap — each image still has its own 12 MB cap.

Recommendations for best results

These are guidelines, not hard limits. Suboptimal images are still processed; results just become less reliable. If extraction fails because the image is unreadable, you receive a clear result code (IMAGE_UNREADABLE, NO_FACE_DETECTED, DOCUMENT_NOT_IDENTIFIED) so you can act on it.

Privacy

Images you send are processed in memory and never persisted. We do not store the images or any personally identifiable information extracted from them. Only operational metadata (timestamp, latency, result code) is kept for audit purposes. Read our full data handling policy at origoid.com/legal.