api

Validación INE

Sube la imagen frontal de una credencial INE y recibe los datos extraídos junto con el estatus de vigencia contra el padrón del Instituto Nacional Electoral.

Validar sin imagen

Si solo necesitas validar la clave de elector contra el padrón sin imagen, usa el endpoint de Listas PLD / AML con services.ine: true.


Endpoint

POST/api/v1/government/mx/ine/verify

Verifica una INE a partir de la imagen del documento

Headers

HeaderValorRequerido
AuthorizationBearer <api-key-jwt>
Content-Typeapplication/json

Body

NombreTipoRequeridoDescripcion
imagestringImagen frontal del INE en base64 (con o sin prefijo data:image/jpeg;base64,)

Ejemplo

curl -X POST https://services.api.jaak.ai/api/v1/government/mx/ine/verify \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d "{\"image\": \"$(base64 < ine_front.jpg)\"}"

Respuesta exitosa (200 OK)

{
  "eventId": "evt_123abc",
  "requestId": "req_456def",
  "timestamp": "2026-04-25T10:30:00Z",
  "processTime": 1200.5,
  "status": "success",
  "data": {
    "estado": "CDMX",
    "municipio": "Cuauhtémoc",
    "nombre": "JUAN",
    "apellidoPaterno": "PÉREZ",
    "apellidoMaterno": "GARCÍA",
    "curp": "PEGJ800115HDFRRL09",
    "ocr": "1234567890123",
    "cic": "123456789",
    "vigencia": "2028-01-15",
    "sexo": "HOMBRE",
    "modelo": "2020",
    "tipo": "TEMPORAL"
  }
}

Errores

HTTPerrorCodeDescripción
400GOV_VINE_004Falta el campo image
401API Key inválida
503GOV_VINE_002Servicio Validaine no disponible
500GOV_VINE_006Error verificando contra INE

Notas

  • Resolución mínima recomendada: 1500 px de ancho. Para más detalle ver Captura óptima de documentos.
  • El campo vigencia viene en formato ISO YYYY-MM-DD.
  • modelo indica la generación de la INE (2008, 2013, 2014, 2019, 2020, etc.).