> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # API de vigencia de credencial INE en México > Verifica la vigencia de la credencial INE de México con Didit en la base de datos oficial. Pago por consulta desde $0.20, sin contratos ni mínimos. 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 | Campo | Obligatorio | Ejemplo | | - | -: | - | | `cic` | No | `123456789` | | `identificador_ciudadano` | No | `123456789` | | `ocr` | No | `1234567890123` | | `voter_number` | No | `ABCDEF123456` | | `emission_number` | No | `01` | | `first_name` | No | `John` | | `last_name` | No | `Doe` | | `date_of_birth` | No | `1990-01-01` | | `vendor_data` | No | `user-1234` | * **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 **issuing\_state** `string` *required* (default: MEX) Código de país ISO 3166-1 alfa-3 para este servicio de base de datos. Ejemplo: `MEX` **services** `string` *required* (default: mex\_ine\_vigencia) Array que contiene el ID de este servicio. Fijar el servicio limita la solicitud a esta base de datos concreta. Ejemplo: `mex_ine_vigencia` **cic** `string` (default: 123456789) Valor de `cic` requerido por este servicio de base de datos. Ejemplo: `123456789` **identificador\_ciudadano** `string` Valor de `identificador_ciudadano` requerido por este servicio de base de datos. Ejemplo: `123456789` **ocr** `string` Valor de `ocr` requerido por este servicio de base de datos. Ejemplo: `1234567890123` **voter\_number** `string` Valor de `voter_number` requerido por este servicio de base de datos. Ejemplo: `ABCDEF123456` **emission\_number** `string` Valor de `emission_number` requerido por este servicio de base de datos. Ejemplo: `01` **first\_name** `string` Nombre de pila que se va a validar. Ejemplo: `John` **last\_name** `string` Apellido que se va a validar. Ejemplo: `Doe` **date\_of\_birth** `string` Fecha de nacimiento en formato `YYYY-MM-DD`. Ejemplo: `1990-01-01` **vendor\_data** `string` (default: 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 ```bash cURL theme={null} curl -X POST "https://verification.didit.me/v3/database-validation/" \ -H "x-api-key: YOUR_API_KEY" \ -F "issuing_state=MEX" \ -F "services=mex_ine_vigencia" \ -F "vendor_data=user-1234" \ -F "cic=123456789" ``` ```python Python theme={null} from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.database_validation.validate( issuing_state="MEX", services=["mex_ine_vigencia"], cic="123456789", vendor_data="user-1234", ) print(result) ``` ```javascript Node.js theme={null} import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.databaseValidation.validate({ issuing_state: "MEX", services: ["mex_ine_vigencia"], cic: "123456789", vendor_data: "user-1234", }); console.log(result); ``` ```go Go theme={null} ctx := context.Background() // Reads DIDIT_API_KEY. client := didit.NewClient() result, err := client.DatabaseValidation.Validate(ctx, didit.DatabaseValidationValidateParams{ IssuingState: "MEX", Services: didit.Some([]string{"mex_ine_vigencia"}), Cic: didit.String("123456789"), VendorData: didit.String("user-1234"), }) if err != nil { log.Fatal(err) } fmt.Printf("%+v\n", result) ``` ```java Java theme={null} import java.util.List; import me.didit.Didit; import me.didit.types.DatabaseValidationValidateParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.databaseValidation().validate(DatabaseValidationValidateParams.builder() .issuingState("MEX") .services(List.of("mex_ine_vigencia")) .cic("123456789") .vendorData("user-1234") .build()); System.out.println(result); ``` ```php PHP theme={null} databaseValidation->validate([ 'issuing_state' => 'MEX', 'services' => ['mex_ine_vigencia'], 'cic' => '123456789', 'vendor_data' => 'user-1234', ]); print_r($result->toArray()); ``` ```ruby Ruby theme={null} require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.database_validation.validate( issuing_state: "MEX", services: ["mex_ine_vigencia"], cic: "123456789", vendor_data: "user-1234" ) puts result.to_h ``` ```csharp .NET theme={null} using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.DatabaseValidation.ValidateAsync(new DatabaseValidationValidateParams { IssuingState = "MEX", Services = new string[] { "mex_ine_vigencia" }, Cic = "123456789", VendorData = "user-1234", }); Console.WriteLine(JsonSerializer.Serialize(result)); ``` Toda llamada exitosa devuelve HTTP `200`. El campo **`outcome_code`** te indica lo que ocurrió realmente; distingue, por ejemplo, una discrepancia biométrica real (`BIOMETRIC_NO_MATCH`) de una selfie que no se pudo leer (`BIOMETRIC_IMAGE_UNUSABLE`). El `status` que se muestra es el estado predeterminado de la función; tus [acciones de Partial Match / No Match](https://docs.didit.me/es/core-technology/database-validation/database-validation-warnings.md) configuradas pueden sobrescribirlo. **`MATCH`**: El registro confirmó la identidad y todos los campos comprobados coincidieron. ```json 200 OK — MATCH theme={null} { "request_id": "req_01H…", "status": "Approved", "issuing_state": "MEX", "match_type": "full_match", "validations": [ { "outcome_code": "MATCH", "service_id": "mex_ine_vigencia", "service_name": "Mexico - INE credential validity verification", "source_data": { "emission_number": "SAMPLE-12345", "emission_year": "sample_value", "expiration_date": "1990-01-01", "federal_district": "sample_value", "identification_number": "SAMPLE-ID-12345", "message": "sample_value", "message_code": "sample_value", "ocr": "sample_value", "registration_year": "sample_value", "validation_code": "SAMPLE-12345", "voter_number": "SAMPLE-12345" }, "validation": { "identification_number": "full_match" } } ] } ``` **`NO_MATCH`**: El registro no devolvió ninguna coincidencia para los datos enviados. ```json 200 OK — NO_MATCH theme={null} { "request_id": "req_01H…", "status": "Declined", "issuing_state": "MEX", "match_type": "no_match", "validations": [ { "outcome_code": "NO_MATCH", "service_id": "mex_ine_vigencia", "service_name": "Mexico - INE credential validity verification", "source_data": { "identification_number": "NO_MATCH" }, "validation": { "identification_number": "no_match" } } ] } ``` ## 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 * [Descripción general de la Validación de base de datos de México](https://docs.didit.me/api-reference/database-validation/mexico.md) * [Descripción general de la Validación de base de datos](https://docs.didit.me/es/core-technology/database-validation/overview.md) * [Códigos de resultado](https://docs.didit.me/es/core-technology/database-validation/database-validation-outcome-codes.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.