Saltar al contenido principal
cURL
curl -X POST https://api.origoid.com/mex/id/v1/voter-list-validations \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"cic": "123456789", "citizenIdentifier": "987654321", "ocr": "0123456789012"}'
{
  "status": "OK",
  "type": "VALID_VOTER",
  "message": "INE valid and active for voting",
  "data": {
    "isValid": true,
    "personalInfo": {
      "electorKey": "GOMEZJ80010112H300"
    },
    "electoralGeography": {
      "federalDistrict": "12",
      "localDistrict": "5"
    },
    "validity": {
      "registrationYear": "2000",
      "emissionYear": "2023",
      "validUntilYear": "2033",
      "emissionNumber": "05"
    },
    "security": {
      "cic": "123456789",
      "ocr": "1234567890123"
    },
    "validationStatus": {
      "stolenReport": null,
      "officialMessage": "Está vigente como medio de identificación y puede votar"
    }
  },
  "transactionId": "f1a2b3c4-d5e6-7f8a-9b0c-123456789001",
  "processedAt": "2026-03-15T12:35:00-06:00",
  "billable": true
}

Autorizaciones

​
x-api-key
string
header
requerido

Cuerpo

application/json
​
cic
string
requerido

Credential Identification Code (9 digits, back)

Ejemplo:

"123456789"

​
citizenIdentifier
string
requerido

Citizen Identifier (9 digits, back, Models E/E+)

Ejemplo:

"987654321"

​
ocr
string

OCR (13 digits, back, Model D)

Ejemplo:

"0123456789012"

Respuesta

Business Responses (Strict Envelope Pattern).

​
status
enum<string>
requerido

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.

Opciones disponibles:
OK,
ERROR
​
type
string
requerido

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
requerido

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

​
transactionId
string<uuid>
requerido

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

​
processedAt
string<date-time>
requerido

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

​
billable
boolean
requerido

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.