Saltar al contenido principal
POST
Verifica una credencial para votar mexicana INE / IFE contra el registro del INE (modelo, vigencia, válida como identificación, derecho a votar). Didit ofrece este servicio a través de POST /v3/database-validation/ para que puedas verificar los datos enviados contra la fuente oficial y recibir resultados de coincidencia normalizados.

Cobertura

  • Cobertura: —
  • País: México
  • ID del servicio: mex_ine_vigencia
  • Dominio de datos: Identidad
  • Categoría: NationalIDRegistry

Datos de entrada

  • Datos de entrada obligatorios: —
  • Datos de entrada opcionales: cic, identificador_ciudadano, ocr, voter_number, emission_number, first_name, last_name, date_of_birth, vendor_data
  • Consentimiento: No es necesario
  • Disponibilidad en flujos de verificación (workflows): Disponible en el flujo
  • Cobertura: —
  • Precio: $0.20 por consulta exitosa

Parámetros del cuerpo

string
predeterminado:"MEX"
requerido
Código de país ISO 3166-1 alfa-3 para este servicio de base de datos.Ejemplo: MEX
string
predeterminado:"mex_ine_vigencia"
requerido
Array que contiene el ID de este servicio. Fijar el servicio limita la solicitud a esta base de datos concreta.Ejemplo: mex_ine_vigencia
string
predeterminado:"123456789"
Valor de cic requerido por este servicio de base de datos.Ejemplo: 123456789
string
Valor de identificador_ciudadano requerido por este servicio de base de datos.Ejemplo: 123456789
string
Valor de ocr requerido por este servicio de base de datos.Ejemplo: 1234567890123
string
Valor de voter_number requerido por este servicio de base de datos.Ejemplo: ABCDEF123456
string
Valor de emission_number requerido por este servicio de base de datos.Ejemplo: 01
string
Nombre de pila que se va a validar.Ejemplo: John
string
Apellido que se va a validar.Ejemplo: Doe
string
Fecha de nacimiento en formato YYYY-MM-DD.Ejemplo: 1990-01-01
string
predeterminado:"user-1234"
Tu referencia estable de usuario para esta persona, como tu ID de usuario interno. Didit la usa para vincular las verificaciones independientes al mismo usuario final y reducir el ruido en la detección de duplicados.Ejemplo: user-1234

Reglas de entrada y notas de validación

  • Proporciona al menos un identificador de la credencial: cic, identificador_ciudadano, ocr o voter_number. Si faltan todos, Didit devuelve HTTP 400 con los campos aceptados en lugar de llamar al proveedor. Las solicitudes rechazadas antes de consultar la fuente no se cobran.
  • Para una credencial antigua identificada por voter_number, incluye emission_number.
  • Un rechazo del proveedor sigue siendo una validación completada con HTTP 200 y contiene el resultado normalizado real. Por ejemplo, el código de proveedor 4 se devuelve como outcome_code: "INVALID_DOCUMENT_FORMAT", outcome_detail: "4" y source_data.message: "Error de datos". Usa estos campos en lugar de tratar cada rechazo como un error genérico de disponibilidad.
  • El código de proveedor 0 significa que no se encontró la credencial enviada. Se devuelve como outcome_code: "DOCUMENT_NOT_FOUND", con outcome_detail: "0" y la explicación original en source_data.message.
  • Los códigos de proveedor 1 y 10 significan que los datos de la credencial enviada no coincidieron con el registro del INE. Se devuelven como outcome_code: "NO_MATCH", con el código del proveedor en outcome_detail y la explicación original en source_data.message.

Cómo invocarlo

Datos devueltos

Los campos exactos que aparecen en source_data dependen de lo que devuelva el registro. El ejemplo generado para mex_ine_vigencia documenta actualmente esta estructura normalizada:
  • emission_number
  • emission_year
  • expiration_date
  • federal_district
  • identification_number
  • message
  • message_code
  • ocr
  • registration_year
  • validation_code
  • voter_number

Precios y SLA

Las consultas de verificación de vigencia de la credencial INE de México se facturan solo cuando Didit recibe un resultado concluyente de la fuente de validación.
  • Precio por llamada: $0.20 USD.
  • Facturación: por consulta exitosa. No se te cobra cuando el registro no está accesible, cuando faltan campos obligatorios o cuando la solicitud se rechaza antes de llegar a la fuente.
  • Latencia: p95 típico < 2 s.
  • Disponibilidad: 99.9% por trimestre por parte de Didit; la disponibilidad de la fuente externa varía según el país y el conjunto de datos.

Continúa leyendo

Última modificación el 1 de noviembre de 2026