API integral de datos de México en tiempo realConsulta de información básica de la CURP
/curp/query_by_curp-20%0.05 USDT/llamada0.04 USDT/llamadaInstrucciones de facturación gratuita: no se realizará ningún cobro en caso de anomalías.
Facturación de resultados vacíos: la API admite hasta 10 resultados vacíos gratuitos al día.
Definición de resultado vacío: el servidor no encontró datos y devolvió un resultado vacío.
Consulta la información básica de una CURP mexicana mediante la CURP.
Estos ejemplos contienen datos sintéticos completos. Usa tus propios datos autorizados en Online Test para ver la respuesta real de la API.
Empieza a usar este endpoint
- Crea una cuenta o usa la que ya tienes.
- Copia tu token de API en Cuenta → Seguridad.
- Ingresa tu token y los datos que tienes autorización para consultar en Prueba en Línea. Los ejemplos enmascarados solo muestran el formato; debes sustituirlos.
Las pruebas en línea están sujetas a la cuota de pruebas de tu cuenta y a las reglas del gateway. Para llamadas de producción, revisa el precio del endpoint y tu saldo antes de enviar. Ver saldo y recargar
Encabezados
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
X-Api-Token | string | Requerido | Tu token de API de la plataforma |
Parámetros
| Nombre | En | Tipo | Requerido | Ejemplo | Descripción |
|---|---|---|---|---|---|
curp | query | string | Requerido | TEST900101HDFABC01 | 18-character CURP code |
Respuesta 200JSON
{
"data": {
"curp": "TEST900101HDFABC01",
"nombres": "SAMPLE USER",
"apellidoPaterno": "SAMPLE USER",
"apellidoMaterno": "SAMPLE USER",
"fechaNacimiento": "1990-01-01",
"sexo": "M",
"nacionalidad": "MEX",
"estadoNacimiento": "GT",
"statusCurp": "RCN",
"docProbatorio": 1,
"datosDocProbatorio": {
"anioReg": "1978",
"numActa": "0000000000",
"claveEntidadRegistro": "11",
"claveMunicipioRegistro": "003"
}
},
"status": 200,
"message": "Found",
"success": true
}Origen de los datos
- En poder de
- RENAPO — Registro Nacional de Población (Secretaría de Gobernación) Sitio oficial
- Categoría de datos
- Identidad civil y validación de CURP
- País
- México · Institución pública
API Pull no tiene una copia propia de este registro. Cada llamada se reenvía a la fuente indicada arriba y la respuesta se devuelve tal como llega; la exactitud y la disponibilidad dependen de esa fuente.
Límites y cuota gratuita
- Solicitudes por segundo
- 10
- Resultados vacíos gratis al día
- 10
Las llamadas que no devuelven registro no se cobran, hasta esta cantidad por día. Pasado ese punto, un resultado vacío se cobra al precio unitario.
El saldo se consume al momento de la llamada. Cuando no la cubre, el gateway devuelve 402 y la llamada no se realiza.
Códigos de error
Códigos de estado observados en producción, con cómo atender cada uno. Los códigos no listados no han ocurrido.
| Código | Qué significa y qué hacer |
|---|---|
200 | La petición llegó a la fuente original y se devolvió una respuesta. Incluye el caso “sin registro”, así que revisa la carga y no solo el código. |
402 | El saldo prepagado no cubría la llamada. La llamada no se realizó y no se cobró nada. Recarga y reintenta. |
504 | La fuente original no respondió a tiempo. Reintenta después; es el modo de falla normal de registros lentos. |
404 | La ruta no existe, o el endpoint ya no está publicado. |
401 | Token de API ausente o inválido. |
Condiciones de uso
Este endpoint devuelve datos personales de una persona identificable en poder de un registro o institución nacional. Debes contar con una base legal para cada identificador que consultes, no debes enumerar rangos de identificadores y no debes usar un resultado como base única de una decisión que afecte negativamente a alguien.