Skip to main content
cURL
curl -X POST https://api.origoid.com/mex/id/v1/voter-id-extractions \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"front": "string"}'
{
  "status": "OK",
  "type": "SUCCESS",
  "message": "Document processed successfully",
  "data": {
    "documentType": "IFE",
    "model": "D",
    "personalInfo": {
      "givenNames": "RAQUEL",
      "firstSurname": "MIRANDA",
      "secondSurname": "ARAUJO",
      "dateOfBirth": "1979-02-19",
      "gender": "M",
      "curp": "MXAR790219MSLRRQ00",
      "electorKey": "MRARRQ79021925M800"
    },
    "address": {
      "addressLine1": "C EL CAPULE 392",
      "addressLine2": "FRACC JARDINES DE LA SIERRA 80019",
      "addressLine3": "CULIACAN, SIN."
    },
    "addressNormalized": {
      "geocodingStatus": "VERIFIED",
      "street": "Calle El Capule",
      "exteriorNumber": "392",
      "interiorNumber": null,
      "neighborhood": "Fraccionamiento Jardines de la Sierra",
      "zipCode": "80019",
      "municipality": "Culiacán",
      "state": "Sinaloa",
      "country": "Mexico"
    },
    "electoralGeography": {
      "state": "25",
      "municipality": "006",
      "section": "1218",
      "locality": "0001"
    },
    "validity": {
      "registrationYear": "1999",
      "emissionNumber": "03",
      "emissionYear": "2014",
      "validUntilYear": "2024"
    },
    "security": {
      "cic": "119195412",
      "ocr": "1218079288742",
      "citizenIdentifier": "079288742",
      "barCode": "119195412",
      "qr": "http://qr.ife.org.mx/121807928874203119195412/20140626/S/006176",
      "mrz": "IDMEX1191954121<<12180792887427902192M2412311MEX<03<<10110<1MIRANDAARAUJO<<RAQUEL27demarz"
    },
    "mrzValidation": {
      "dateOfBirth": true,
      "gender": true,
      "validity": true,
      "emission": true,
      "cic": true,
      "name": false
    },
    "qrValidation": {
      "cic": true,
      "ocr": true,
      "citizenIdentifier": true
    },
    "files": [
      {
        "kind": "face",
        "contentType": "image/jpeg",
        "sizeBytes": 8421,
        "content": "/9j/4AAQSkZJRgABAQEAYABgAAD...TRUNCATED_BASE64.../9k="
      }
    ]
  },
  "billable": true,
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "processedAt": "2026-03-15T19:23:00-06:00"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
front
string
required

Front image in Base64 (PNG/JPG)

​
back
string

Back image in Base64 (PNG/JPG). Optional.

Response

Extraction results (Strict Envelope Pattern).

​
status
enum<string>
required

High-level outcome. OK means the request was successfully processed (regardless of business result). ERROR means the request was rejected or could not be processed.

Available options:
OK,
ERROR
​
type
string
required

Stable result type code. Includes generic codes (SUCCESS, INVALID_REQUEST, UNAUTHORIZED, SERVICE_UNAVAILABLE, INTERNAL_ERROR, RATE_LIMIT_EXCEEDED) plus endpoint-specific result codes — see this endpoint's response examples.

​
message
string
required

Human-readable summary of the result. Always in English (per Language Conventions in the API overview).

​
transactionId
string<uuid>
required

Unique identifier of this request, generated by the API Gateway. Propagated end-to-end for traceability.

​
processedAt
string<date-time>
required

ISO 8601 datetime with Mexico City offset (-06:00). Always set by the API Gateway when the response leaves the system.

​
billable
boolean
required

Whether this request will be charged against the client's plan. Typically true for successful business results and false for validation errors or system errors that prevented processing.

​
data
object

Response payload. null on error responses. Shape depends on the endpoint — see each operation's response schema.

​
errors
object[]

Per-field error details. Present only on INVALID_REQUEST responses.