Endpoint: validación de credencial INE (México)

Valida una credencial para votar del INE por su CIC de nueve dígitos o por el OCR de trece dígitos con clave de elector y número de emisión. Devuelve el estatus y la vigencia reportados por el validador; no publica nombre, datos biográficos ni metadatos de emisión. «Datos no encontrados» es la única negativa válida y cobra; un fallo de captcha o de la fuente no cobra.

POST/api/ine-mx1 crédito

Valida una Credencial para Votar mexicana con el validador público de Finanzas CDMX contra el INE. Acepta el CIC de 9 dígitos o la combinación OCR de 13 + clave de elector de 18 + emisión de exactamente 2 dígitos; una forma incompleta responde 400 sin cobrar ni gastar proxy/captcha. Publica el estatus literal de la fuente (VIGENTE, NO_VIGENTE u otro que aparezca), encontrado y vigente; si el estado es nuevo, vigente queda null en vez de deducirse. NO entrega nombre, datos biográficos ni metadatos de emisión. DATOS_NO_ENCONTRADOS responde 404 no_encontrado y reembolsa; un captcha rechazado dos veces o una falla de la fuente responde sin cobrar y nunca se convierte en negativa. Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)

{
  "documento": "000000000"
}

Parámetros del cuerpo de la solicitud
Campo	Tipo	Qué es
documentoobligatorio	string	CIC de 9 dígitos o OCR de 13. Alias: `documentNumber`, `cic`, `ocr`, `docNumber`.
claveElector	string	Obligatoria cuando `documento` es un OCR de 13: clave de elector de 18 caracteres. Alias: `clave_elector`, `claveDeElector`, `clave`.
numeroEmision	string	Obligatoria cuando `documento` es un OCR de 13: número de emisión de exactamente 2 dígitos. Alias: `numero_emision_credencial`, `emissionNumber`, `emision`.
refresh	boolean	Ignora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL

curl -X POST 'https://placapi.com/api/ine-mx' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"documento":"000000000"}'

JavaScript (fetch)

const res = await fetch("https://placapi.com/api/ine-mx", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"documento":"000000000"}),
});
const data = await res.json();

Python (requests)

import requests

res = requests.post(
    "https://placapi.com/api/ine-mx",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"documento":"000000000"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)

{
  "source": "ineMx",
  "status": "ok",
  "data": {
    "documento": "000000000",
    "tipoDocumento": "INE",
    "tipoIdentificador": "CIC",
    "estatus": "VIGENTE",
    "encontrado": true,
    "vigente": true,
    "cobertura": {
      "estatus": true,
      "vigente": true,
      "nombre": false,
      "datosBiograficos": false,
      "metadatosEmision": false
    }
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 1
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 30 de octubre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.