Documentación API

Documentación de la API

Guía completa para integrar y utilizar los servicios de verificación de CURP de I Data.

Autenticación

Para utilizar la API, debes incluir tu API key en el encabezado de cada solicitud:

Encabezado Requerido

Todas las solicitudes a la API deben incluir el siguiente encabezado HTTP:

api-key: rc_xXXXXXXXXXXXX

Endpoints

URL del Host

Para ver la URL completa del host, necesitas iniciar sesión en la plataforma. Una vez autenticado, podrás acceder a la URL específica de tu entorno.

GET
Verificar CURP

Verifica la autenticidad de una CURP existente.

GET {{host}}/api/mexico/renapo/v1/curp/{{CURP}}

POST
Valida CURP

Genera una CURP a partir de los datos proporcionados.

POST {{host}}/api/mexico/renapo/v1/curp Body a enviar (JSON):{
    "nombres": "JOE",
    "primerApellido": "DOE",
    "segundoApellido": "S",
    "diaNacimiento": "17",
    "mesNacimiento": "10",
    "selectedYear": 1996,
    "sexo": "H",
    "claveEntidad": "QROO"
}

Códigos de Sexo

Utiliza estos códigos para el parámetro sexo al generar una CURP:

Código	Descripción
M	Mujer
H	Hombre
X	No binario

Códigos de Estados Mexicanos

Utiliza estos códigos para el parámetro claveEntidad al generar una CURP:

Código	Estado
AS	Aguascalientes
BC	Baja California
BS	Baja California Sur
CC	Campeche
CL	Coahuila
CM	Colima
CS	Chiapas
CH	Chihuahua
DF	Ciudad de México
DG	Durango
GT	Guanajuato
GR	Guerrero
HG	Hidalgo
JC	Jalisco
MC	Estado de México
MN	Michoacán
MS	Morelos
NT	Nayarit
NL	Nuevo León
OC	Oaxaca
PL	Puebla
QT	Querétaro
QR	Quintana Roo
SP	San Luis Potosí
SL	Sinaloa
SR	Sonora
TC	Tabasco
TS	Tamaulipas
TL	Tlaxcala
VZ	Veracruz
YN	Yucatán
ZS	Zacatecas
NE	Nacido en el extranjero

Ejemplos de Respuesta

Respuesta Exitosa

{
    "registros": [
        {
            "datosDocProbatorio": {
                "claveMunicipioRegistro": "015",
                "municipioRegistro": "GUADALAJARA",
                "anioReg": "1990",
                "foja": "",
                "tomo": "",
                "libro": "",
                "numActa": "02548",
                "claveEntidadRegistro": "14",
                "entidadRegistro": "JALISCO"
            },
            "parametro": "?curp=GARA900315HJCLMN09&pcurp=8B5D4EF3A2C1B7E6F891D042653A7158&hash=a4b8c9d5e2f1a8b7c3d6e9f4a1b2c5d8e7f3a6b9",
            "nombres": "CARLOS ALEJANDRO",
            "statusCurp": "RCN",
            "docProbatorio": 1,
            "primerApellido": "GARCIA",
            "entidad": "JALISCO",
            "segundoApellido": "RAMIREZ",
            "curp": "GARA900315HJCLMN09",
            "fechaNacimiento": "15/03/1990",
            "sexo": "HOMBRE",
            "nacionalidad": "MEXICO",
            "claveEntidad": "JC"
        }
    ],
    "codigo": "01",
    "mensaje": "Búsqueda exitosa por curp"
}

Error de Validación

{
    "mensaje": "Estimado/a usuario/a: Los datos ingresados no son correctos. Verifica e inténtalo de nuevo. En caso de que persista la misma respuesta, favor de enviar un correo electrónico a tramitecurp@segob.gob.mx, describiendo claramente la situación a atender y anexando copia de tu acta de nacimiento y de una identificación oficial. Gracias.",
    "codigo": "180001"
}

Descarga del PDF

Una vez que obtienes una respuesta exitosa de verificación de CURP, puedes descargar el PDF oficial utilizando la propiedad 'parametro' que se devuelve en la respuesta.

URL de Descarga

Construye la URL de descarga concatenando la URL base con el parámetro devuelto:

https://consultas.curp.gob.mx/CurpSP/pdfgobmx{{parametro}}

Ejemplo Completo

Basándose en la respuesta de ejemplo anterior, la URL completa sería:

https://consultas.curp.gob.mx/CurpSP/pdfgobmx?curp=GARA900315HJCLMN09&pcurp=8B5D4EF3A2C1B7E6F891D042653A7158&hash=a4b8c9d5e2f1a8b7c3d6e9f4a1b2c5d8e7f3a6b9

Vista Previa del PDF

El PDF descargado contendrá la información oficial de la CURP como se muestra a continuación:

Nota Importante

La propiedad 'parametro' solo estará disponible en respuestas exitosas (código '01'). Asegúrate de verificar el código de respuesta antes de intentar construir la URL de descarga del PDF.

Códigos de Error

400

Solicitud inválida

401

No autorizado

403

Prohibido

404

Recurso no encontrado

429

Demasiadas solicitudes

500

Error del servidor