/v1/ine/verify
Verifica una credencial para votar con el servicio de Lista Nominal del INE y recibe si está vigente, con el registro que el INE tiene de ella. Tarda 4 a 15 segundos y cuesta 10 créditos.
Úsalo para confirmar que una credencial que te muestran fue emitida por el INE y sigue siendo válida como identificación. La respuesta cubre la credencial, no a la persona: compara la clave de elector y la foto de la credencial con quien tienes enfrente.
Esta verificación es un paso de un trabajo más grande. La guía de MexCheck los recorre todos: KYC y alta de clientes.
Cuerpo de la solicitud
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
cic |
string | Sí | El Código de Identificación de la Credencial (CIC), hasta 9 dígitos. En el reverso de la credencial, son los nueve dígitos después de IDMEX en la primera línea. |
id_ciudadano |
string | Uno de los dos | El identificador del ciudadano, hasta 9 dígitos, para los modelos E a J: los últimos nueve dígitos de la primera línea del reverso. |
ocr |
string | Uno de los dos | El OCR de 13 dígitos, para credenciales modelo D. Envíalo en lugar de id_ciudadano. |
Dónde encontrar los identificadores
Ambos identificadores están en la primera línea de la zona de lectura mecánica del reverso de la credencial. Los diagramas del propio INE:
Pruébalo
/v1/ine/verify
Inicia sesión para enviar una solicitud real desde esta página.
Las cuentas nuevas reciben $5 USD de crédito al registrarse, sin tarjeta.
Solicitud de ejemplo
curl -X POST https://inecheck.com/v1/ine/verify \
-H "x-api-key: rfc_your_api_key" \
-H "Content-Type: application/json" \
-d '{"cic": "123456789", "id_ciudadano": "987654321"}'
Respuesta (200)
{
"cic": "123456789",
"found": true,
"status": "vigente",
"message": "INE reports this credential is current.",
"credential": {
"modelo": "e",
"status": "vigente",
"found": true,
"vigente": true,
"puede_votar": true,
"en_padron_electoral": true,
"en_lista_nominal": true,
"cic": "123456789",
"clave_elector": "PRMRJN80010109H400",
"numero_emision": "2",
"distrito_federal": "1",
"distrito_local": "19",
"ocr": "1234567890123",
"anio_registro": "2011",
"anio_emision": "2022",
"fecha_actualizacion": "2026-11-04T04:29:00",
"fecha_consulta": "2026-11-04",
"vigencia": "2032-12-31",
"mensaje": "Esta vigente como medio de identificación."
}
}
found es true (el INE regresó el registro en credential), false (el INE respondió sin registro: status indica si los identificadores no coincidieron con nada o si la credencial ya no es vigente, y message trae la frase del propio INE) o null (no se pudo contactar al INE, reintenta más tarde). Una respuesta false cuesta 10 créditos. Una respuesta null no se cobra.
El INE responde no_encontrada tanto para identificadores mal capturados como para una credencial que fue reemplazada por una más reciente (un trámite posterior), así que una credencial anterior que la persona todavía conserva regresa como no encontrada. Pide la credencial más reciente.
Cómo leer la credencial
-
vigente: el INE reporta la credencial como identificación válida. vigencia es la fecha en que vence. -
en_padron_electoral,en_lista_nominal: si el INE ubica al titular en el Padrón Electoral y en la Lista Nominal. -
puede_votar: true solo cuando el INE también ubica al titular en la Lista Nominal. Una credencial puede estar vigente como identificación aunque su titular no esté en la lista, así que revisa vigente en flujos de identidad. -
fecha_actualizacion,fecha_consulta: cuándo actualizó el INE el registro por última vez y el día en que se hizo la consulta, tal como los imprime el INE.
Errores
-
422 invalid_fields: fields lista lo que hay que corregir: un cic ausente o no numérico, o no exactamente uno de id_ciudadano y ocr. No se cobra.