Validación de información en instituciones mexicanas (v1.1.0)
Download OpenAPI specification:Download
Esta API permite consultar información de RFC, CURP y credenciales INE en México. Facilita la validación de datos personales y fiscales, accediendo a bases oficiales del gobierno mexicano. Ideal para integraciones en sistemas legales, fiscales y administrativos.
Recibe los resultados de la validacion de INE Webhook
Authorizations:
Request Body schema: application/json
| valid | boolean Indica si la credencial INE está vigente y es válida. |
| messages | Array of strings |
| expired | boolean Especifica si la credencial de elector ha expirado. |
| court_order | boolean Señala si la credencial cuenta con una orden judicial asociada. |
| incorrect_data | boolean Se informa si la credencial contiene errores o datos incorrectos. |
| cic | string Clave asignada para la identificación única del ciudadano. |
| elector_key | string <= 18 characters Clave de elector, presente en la credencial INE. |
| ocr | string Número OCR impreso en la credencial de elector. |
| registered_at | string <= 4 characters Año en que se efectuó el registro correspondiente. |
| emission_at | string <= 4 characters Año en que se emitió la credencial o documento. |
| federal_district | string <= 3 characters Número de distrito federal electoral correspondiente. |
| local_district | string <= 3 characters Número de distrito electoral local asignado. |
| emission_number | string <= 2 characters Número asignado a la emisión de la credencial. |
Responses
Request samples
- Payload
{- "valid": true,
- "messages": [
- "Fecha de actualización de la información: 23 de noviembre del 2023 20:08",
- "Fecha de consulta: 24 de noviembre del 2023"
], - "expired": false,
- "court_order": false,
- "incorrect_data": false,
- "cic": "189082445",
- "elector_key": "FRJMER94122309H903",
- "ocr": "4102023451456",
- "registered_at": "2016",
- "emission_at": "2021",
- "federal_district": "01",
- "local_district": "01",
- "emission_number": "01"
}Recibe los errores de la validacion de INE Webhook
Authorizations:
Request Body schema: application/json
| valid | boolean Indica si la credencial es valida |
| error | string Mensaje de error |
Responses
Request samples
- Payload
{- "valid": false,
- "error": "INE website under maintenance"
}Consultar información del RFC.
Obtiene información del Registro Federal de Contribuyentes (RFC) accediendo directamente al sitio oficial del gobierno. Esta consulta permite verificar la existencia y datos asociados a un RFC.
Authorizations:
Request Body schema: application/json
| rfc required | string The RFC to search |
| name | string The name of the person or company required with the postal code |
| postal_code | string The postal code of the person or company required with the name |
Responses
Request samples
- Payload
{- "rfc": "EKM1404018J1",
- "name": "Eduardo",
- "postal_code": "12345"
}Response samples
- 200
- 422
- 500
{- "success": true,
- "result": {
- "rfc": "EKM1404018J1",
- "valid_rfc": true,
- "elegible_for_invoices": true,
- "message": "RFC válido y susceptible de recibir facturas"
}
}Consulta inversa de RFC.
Realiza la búsqueda inversa del RFC utilizando la información disponible en el sitio oficial del gobierno. Permite obtener datos asociados a un RFC, partiendo de diferentes parámetros identificadores.
Authorizations:
Request Body schema: application/json
| name required | string The name of the person or company |
| first_last_name | string The first last name of the person, required for physical person |
| second_last_name | string The second last name of the person, required for physical person |
| birth_date required | string The birth date of the person |
| person_type required | string Enum: "PF" "PM" The person type, PF for physical person and PM for moral person |
Responses
Request samples
- Payload
{- "name": "Margarita Gomez Velazquez",
- "first_last_name": "Gomez",
- "second_last_name": "Velazquez",
- "birth_date": "1980-07-05",
- "person_type": "PF"
}Response samples
- 200
- 422
- 500
{- "success": true,
- "result": {
- "rfc": "EKM1404018J1",
- "valid_rfc": true,
- "elegible_for_invoices": true,
- "message": "RFC válido y susceptible de recibir facturas"
}
}Consulta inversa de RFC y CURP.
Obtiene información de RFC y CURP realizando una búsqueda inversa en la base oficial del gobierno. Permite validar ambos identificadores a partir de los datos disponibles.
Authorizations:
Request Body schema: application/json
| curp required | string The CURP of the person |
Responses
Request samples
- Payload
{- "curp": "GOVM800705MCLMLR01"
}Response samples
- 200
- 404
- 422
- 500
{- "success": true,
- "result": {
- "rfc_result": {
- "rfc": "EKM1404018J1",
- "valid_rfc": true,
- "elegible_for_invoices": true,
- "message": "RFC válido y susceptible de recibir facturas"
}, - "curp_result": {
- "curp": "GOVM800705MCLMLR01",
- "valid": true,
- "names": "Margarita",
- "first_last_name": "Gomez",
- "second_last_name": "Velazquez",
- "birth_date": "1980-07-05",
- "gender": "M",
- "nationality": "MEX",
- "birth_federal_entity": "COL",
- "issuing_entity_key": "06",
- "curp_status": "AN",
- "curp_status_description": "Alta Normal",
- "registration_year": "1980",
- "certificate_folio": "",
- "registration_entity_number": "10",
- "municipality_key": "001",
- "foreign_registration_number": "",
- "probatory_document": "Acta de nacimiento",
- "probatory_document_data": {
- "id": "1",
- "name": "Acta de nacimiento",
- "book": "",
- "act_number": "1",
- "sheet": "1",
- "tomo": "",
- "crip": "",
- "letter_folio": ""
}
}
}
}Consultar información de la CURP.
A partir de la CURP proporcionada, se recuperan los datos personales registrados en la base de datos de RENAPO. Esta funcionalidad permite validar y obtener los detalles oficiales asociados a esa CURP.
Authorizations:
Request Body schema: application/json
Contiene los datos relacionados con la CURP consultada, incluyendo información personal y de registro en RENAPO.
| curp required | string = 18 characters |
Responses
Request samples
- Payload
{- "curp": "XXXX910225XXXXXX09"
}Response samples
- 200
- 400
- 404
- 409
- 422
- 500
{- "result": {
- "birth_date": "01/01/2000",
- "birth_federal_entity": "DF",
- "certificate_folio": "9999",
- "curp": "XXXX910225XXXXXX09",
- "curp_status": "RCC",
- "curp_status_description": "Registro Normal",
- "first_last_name": "XXXX",
- "foreign_registration_number": "9999",
- "gender": "H",
- "issuing_entity_key": "99999",
- "municipality_key": "999",
- "name": "XXXX",
- "nationality": "MEX",
- "probatory_document": "",
- "probatory_document_data": {
- "act_number": "99999",
- "book": "9999",
- "crip": "090050291018921",
- "id": "1",
- "letter_folio": "9999",
- "name": "Acta de nacimiento",
- "sheet": "9999",
- "tome": "9999"
}, - "registration_entity_number": "09",
- "registration_year": "2000",
- "second_last_name": "XXXX",
- "valid": true
}, - "success": true
}Generar CURP a partir de datos personales.
Utilizando los datos personales suministrados, se obtiene la CURP correspondiente mediante la base oficial de RENAPO. Esta función es útil cuando se desconoce la CURP y se requiere calcularla a partir de los datos del ciudadano.
Authorizations:
Request Body schema: application/json
Incluye los datos requeridos para generar la CURP, como nombre, apellidos, fecha y entidad de nacimiento, entre otros.
| birth_date required | string <date> Formato de fecha: AAAA-MM-DD (año-mes-día). |
| birth_federal_entity required | string Enum: "AS" "BC" "BS" "CC" "CL" "CM" "CS" "CH" "DF" "DG" "GT" "GR" "HG" "JC" "MC" "MN" "MS" "NT" "NL" "OC" "PL" "QT" "QR" "SP" "SL" "SR" "TC" "TS" "TL" "VZ" "YN" "ZS" |
| first_last_name required | string |
| gender required | string Enum: "H" "M" |
| name required | string |
| second_last_name required | string |
Responses
Request samples
- Payload
{- "birth_date": "1990-01-01",
- "birth_federal_entity": "AS",
- "first_last_name": "Doe",
- "gender": "H",
- "name": "John",
- "second_last_name": "Smith"
}Response samples
- 200
- 400
- 404
- 409
- 422
- 500
{- "result": {
- "birth_date": "01/01/2000",
- "birth_federal_entity": "DF",
- "certificate_folio": "9999",
- "curp": "XXXX910225XXXXXX09",
- "curp_status": "RCC",
- "curp_status_description": "Registro Normal",
- "first_last_name": "XXXX",
- "foreign_registration_number": "9999",
- "gender": "H",
- "issuing_entity_key": "99999",
- "municipality_key": "999",
- "name": "XXXX",
- "nationality": "MEX",
- "probatory_document": "",
- "probatory_document_data": {
- "act_number": "99999",
- "book": "9999",
- "crip": "090050291018921",
- "id": "1",
- "letter_folio": "9999",
- "name": "Acta de nacimiento",
- "sheet": "9999",
- "tome": "9999"
}, - "registration_entity_number": "09",
- "registration_year": "2000",
- "second_last_name": "XXXX",
- "valid": true
}, - "success": true
}Verifica la validez de una credencial INE.
Authorizations:
query Parameters
| webhook required | string |
Request Body schema: application/json
| cic required | string Este campo es obligatorio para los tipos D y EFGH. |
| ocr required | string |
| elector_key | string <= 18 characters |
| emission_number | string <= 2 characters |
Responses
Request samples
- Payload
{- "cic": "189082445",
- "ocr": "4102023451456",
- "elector_key": "FRJMER94122309H903",
- "emission_number": "01"
}Response samples
- 200
- 400
- 422
{- "webhook_uuid": "11ea1db3-664d-49f3-abdc-610b3b1ff546",
- "timestamp": 1647643650116
}
