INE1 tokenPOST

Validación en la lista nominal

Consulta el estatus de una Credencial para Votar en la Lista Nominal del INE. Soporta los modelos C, D, E, F, G y H — cada modelo se identifica con un combo de campos distinto. Devuelve la vigencia, año de emisión y registro, distritos, fechas de actualización y de consulta.

Endpoint

POSThttps://api.datosnonstop.com/v1/ine/lista-nominal

Parámetros

json

{
  "modelo": "c",
  "claveElector": "GNANAL97072431H800",
  "numEmision": "01",
  "ocr": "0494103580547"
}

ParámetroTipoRequeridoDescripción

modelostringSíModelo de la credencial. Determina qué combinación de campos es necesaria.

claveElectorstringNoClave de elector de 18 caracteres. Requerido cuando modelo es c.

numEmisionstringNoNúmero de emisión de la credencial. Requerido cuando modelo es c.

ocrstringNoNúmero OCR de la credencial. Requerido cuando modelo es c o d.

cicstringNoNúmero CIC de la credencial. Requerido cuando modelo es d, e, f, g o h.

idCiudadanostringNoIdentificador del Ciudadano impreso en la credencial. Requerido cuando modelo es e, f, g o h.

Ejemplo rápido

Coloca tu API key en el header x-api-key y agrega el header Content-Type: application/json para enviar el body como JSON.

curl

curl -X POST https://api.datosnonstop.com/v1/ine/lista-nominal \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"modelo":"c","claveElector":"GNANAL97072431H800","numEmision":"01","ocr":"0494103580547"}'

Tip

¿Sabías que al pegar un cURL en Postman te crea automáticamente la llamada con todos los elementos?

Token

Cada consulta consume tokens. Lo que no uses, lo conservas — tu saldo se acumula sin fecha de vencimiento ni reinicios. Puedes consultarlo en cualquier momento desde el dashboard o directamente en el header de cada respuesta x-tokens-remaining.

Respuesta

JSON

200 OK

{
  "id": "6411e0eb8cc8c7bc820d1e59",
  "status": "found",
  "modelo": "c",
  "claveElector": "GNANAL97072431H800",
  "numEmision": "01",
  "ocr": "0494103580547",
  "cic": "220724114",
  "idCiudadano": "103580547",
  "anioEmision": "2021",
  "anioRegistro": "2015",
  "distritoFederal": "4",
  "distritoLocal": "4",
  "fechaActualizacion": "2023-03-14",
  "fechaConsulta": "2023-03-15",
  "vigencia": "2031-12-31",
  "descripcion": "Esta vigente como medio de identificación y puedes votar. Tus datos se encuentran en el Padrón Electoral, y también en la Lista Nominal de Electores."
}

Respuestas en error

JSON

400 Bad Request

[
  {
    "type": "catalog",
    "message": "El valor no existe en el catálogo",
    "field": "modelo"
  },
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "claveElector"
  },
  {
    "type": "required",
    "message": "El campo es requerido",
    "field": "ocr"
  }
]

Campos

Campos de entrada

CampoTipoDescripción

modelostringModelo de la credencial. Determina qué campos adicionales son requeridos en la consulta. Ver catálogo Modelo de credencial.

claveElectorstringClave de elector de 18 caracteres alfanuméricos impresa al frente de la credencial. Requerido cuando modelo es c.

numEmisionstringNúmero de emisión impreso en la credencial; identifica la versión emitida al ciudadano. Requerido cuando modelo es c.

ocrstringCadena OCR impresa al reverso de la credencial. Requerido cuando modelo es c o d.

cicstringClave de Identificación del Ciudadano impresa al reverso de la credencial. Requerido cuando modelo es d, e, f, g o h.

idCiudadanostringIdentificador del Ciudadano impreso al reverso de la credencial. Requerido cuando modelo es e, f, g o h.

Campos de respuesta

CampoTipoDescripción

idstringIdentificador interno de la consulta, útil para soporte y trazabilidad.

statusstringResultado de la consulta de la credencial en la Lista Nominal del INE. Ver catálogo Status.

modelostringModelo de la credencial enviado en la consulta. Ver catálogo Modelo de credencial.

claveElectorstringClave de elector de la credencial. Cuando status es found ecoa el valor reportado por el INE; cuando status es not_found ecoa el valor enviado en la consulta (solo si fue requerido para el modelo).

numEmisionstringNúmero de emisión de la credencial. En not_found ecoa el valor enviado.

ocrstringCadena OCR de la credencial. En not_found ecoa el valor enviado.

cicstringClave de Identificación del Ciudadano. En not_found ecoa el valor enviado.

idCiudadanostringIdentificador del Ciudadano. En not_found ecoa el valor enviado.

messagestringDetalle del motivo cuando status es not_found. Solo está presente en respuestas not_found. Ver catálogo Mensajes not_found.

anioEmisionstringAño de emisión de la credencial vigente del ciudadano. Solo está presente cuando status es found.

anioRegistrostringAño en que el ciudadano se registró en el Padrón Electoral. Solo está presente cuando status es found.

distritoFederalstringDistrito electoral federal donde está registrado el ciudadano. Solo está presente cuando status es found.

distritoLocalstringDistrito electoral local donde está registrado el ciudadano. Solo está presente cuando status es found.

fechaActualizacionstringFecha de la última actualización del registro en formato ISO YYYY-MM-DD. Solo está presente cuando status es found.

fechaConsultastringFecha en la que el INE atendió la consulta en formato ISO YYYY-MM-DD. Solo está presente cuando status es found.

vigenciastringAño de vigencia impreso en la credencial en formato ISO YYYY-MM-DD. Solo está presente cuando status es found.

descripcionstringTexto explicativo del INE sobre la situación de la credencial en la Lista Nominal. Solo está presente cuando status es found.

Catálogos

Tablas de referencia para los valores de los campos enumerados en la sección anterior.

Status

Valores posibles del campo status.

ValorDescripción

foundLa credencial está vigente en la Lista Nominal del INE. La respuesta incluye los datos de la credencial y la fecha de vigencia.

not_foundLa credencial no está vigente o no fue encontrada en la Lista Nominal con los parámetros enviados. La respuesta incluye el campo message con el detalle.

Modelo de credencial

Modelos vigentes y obsoletos de la Credencial para Votar emitidos por el INE/IFE. Cada modelo determina la combinación de campos requeridos en la consulta.

ModeloCampos requeridosDescripción

cmodelo, claveElector, numEmision, ocrCredenciales emitidas hasta 2013 por el IFE. Identifican al ciudadano por la clave de elector y el número de emisión.

dmodelo, cic, ocrCredenciales emitidas entre 2014 y 2019 por el INE. Identifican al ciudadano por el CIC al reverso y la cadena OCR.

emodelo, cic, idCiudadanoCredenciales emitidas a partir de 2019 por el INE. Identifican al ciudadano por el CIC y el Identificador del Ciudadano impresos al reverso.

fmodelo, cic, idCiudadanoVariante posterior del modelo E con el mismo combo de campos.

gmodelo, cic, idCiudadanoVariante posterior del modelo E con el mismo combo de campos.

hmodelo, cic, idCiudadanoVariante vigente del modelo E con el mismo combo de campos.

Mensajes not_found

Mensajes posibles del campo message cuando status es not_found.

MensajeDescripción

No está vigente como medio de identificación y no puedes votar. ¡Esta no es tu última credencial!, realizaste un trámite de actualización de datos, por lo que tu consulta fue con una credencial anterior. Realiza una nueva consulta con tu última credencial.

La credencial existe en los registros del INE pero ya no está vigente porque el ciudadano realizó un trámite posterior con una credencial más reciente.

No se obtuvieron datos de la consulta con los parámetros seleccionados, verifica que no tienes un trámite posteriorNo se encontró una credencial en la Lista Nominal con los parámetros enviados. Revisa que los datos coincidan con la última credencial vigente del ciudadano.

Histórico

Endpoint

GEThttps://api.datosnonstop.com/v1/ine/lista-nominal/historico/{id}

El {id} corresponde al campo id devuelto en la respuesta de la consulta principal.

Si necesitas la lista completa de elementos almacenados, accede a tu dashboard.

La respuesta está sujeta al tiempo de almacenamiento de tu plan. Si requieres más tiempo, cambia de plan en tu dashboard.

Respuesta

JSON

200 OK

{
  "id": "6411e0eb8cc8c7bc820d1e59",
  "status": "found",
  "modelo": "c",
  "claveElector": "GNANAL97072431H800",
  "numEmision": "01",
  "ocr": "0494103580547",
  "cic": "220724114",
  "idCiudadano": "103580547",
  "anioEmision": "2021",
  "anioRegistro": "2015",
  "distritoFederal": "4",
  "distritoLocal": "4",
  "fechaActualizacion": "2023-03-14",
  "fechaConsulta": "2023-03-15",
  "vigencia": "2031-12-31",
  "descripcion": "Esta vigente como medio de identificación y puedes votar. Tus datos se encuentran en el Padrón Electoral, y también en la Lista Nominal de Electores."
}

Respuestas en error

JSON

404 Not Found

[
  {
    "type": "not_found",
    "message": "el id no fue encontrado en el historico"
  }
]

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/ine/lista-nominal

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl

curl -X POST https://sandbox.api.datosnonstop.com/v1/ine/lista-nominal \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"modelo":"c","claveElector":"GNANAL97072431H800","numEmision":"01","ocr":"0494103580547"}'

Casos de prueba

Si envías un valor que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de GNANAL97072431H800.

CasoCampoValor

Modelo C — VigenteclaveElectorGNANAL97072431H800

Modelo D — Vigentecic220724114

Modelo E — Vigentecic220724114

No encontradacic240629814

No vigentecic245296814

Sin tokensclaveElectorGARCMA90030415H024

Error internoclaveElectorHERNJU85091210M312

Unavailable serviceclaveElectorTORREL00112508H789

Endpoint histórico

GEThttps://sandbox.api.datosnonstop.com/v1/ine/lista-nominal/historico/{id}

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

curl

curl https://sandbox.api.datosnonstop.com/v1/ine/lista-nominal/historico/6411e0eb8cc8c7bc820d1e59 \
  -H "x-api-key: tu_api_key_sandbox"

Casos de prueba histórico

Si envías un valor de id que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de 6411e0eb8cc8c7bc820d1e59.

Casoid

Caso exitoso6411e0eb8cc8c7bc820d1e59

No encontrado0000000000000000ffffffff

Fuera de rango1111111111111111aaaaaaaa

Error interno2222222222222222bbbbbbbb

Empezar gratis →