API de Consulta y Validación de CURP (México)

Servicio de consulta y validación oficial de la Clave Única de Registro de Población (CURP) en tiempo real. Esta API permite verificar la autenticidad, vigencia y datos biométricos/registrales asociados ante el Registro Nacional de Población (RENAPO).

La API se encuentra integrada con el gateway de idoo.dev, por lo que toda la autenticación, cuotas de plan y control de límites (rate limiting) son gestionados automáticamente mediante tu API Key de idoo.dev.

Autenticación

Todas las llamadas deben realizarse a través del gateway de idoo.dev incluyendo tu clave de API en el encabezado X-Idoo-Key:

X-Idoo-Key: tu_api_key_aqui

Nota para desarrolladores: En ambiente sandbox, utiliza las credenciales de prueba proporcionadas por idoo.dev.

Endpoint: Consulta por CURP

Permite obtener los datos de identidad y registro civil de una persona física mediante su CURP de 18 caracteres.

Información General

• Método HTTP: GET
• Ruta relativa: /v2/rest/curp/porCurp/{curp}
• Ruta alternativa (Query string): /v2/rest/curp/porCurp?curp={curp}
• URL Base en idoo.dev: https://api.idoo.dev/v1/{slug-de-tu-api}
• Content-Type / Accept: application/json

Parámetros de la Petición

Formato esperado de la CURP:

• Longitud: Exactamente 18 caracteres.
• Patrón (RegEx): ^[A-Z]{4}\d{6}[HMX][A-Z]{5}[A-Z0-9]\d$

Ejemplos de Petición

cURL

curl -X GET "https://api.idoo.dev/v1/{slug-de-tu-api}/v2/rest/curp/porCurp/ROMA900101HDFRRN01" \
  -H "X-Idoo-Key: tu_api_key_aqui" \
  -H "Accept: application/json"

JavaScript (Node.js / Fetch)

const response = await fetch('https://api.idoo.dev/v1/{slug-de-tu-api}/v2/rest/curp/porCurp/ROMA900101HDFRRN01', {
  method: 'GET',
  headers: {
    'X-Idoo-Key': 'tu_api_key_aqui',
    'Accept': 'application/json'
  }
});

const data = await response.json();
console.log(data);

Python (Requests)

import requests

url = "https://api.idoo.dev/v1/{slug-de-tu-api}/v2/rest/curp/porCurp/ROMA900101HDFRRN01"
headers = {
    "X-Idoo-Key": "tu_api_key_aqui",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

Pruebas en Ambiente Sandbox

En el ambiente sandbox, puedes utilizar la siguiente CURP de prueba sintética para validar tu flujo de integración sin consumir créditos reales:

• CURP de Prueba: AAAA000000HDFRRR01

Respuestas de la API

Todas las respuestas de la API utilizan un sobre JSON consistente:

{
  "valid": true,
  "status": 200,
  "message": "Mensaje descriptivo",
  "data": { ... },
  "timestamp": "2026-09-08T18:00:00-06:00"
}

Respuesta Exitosa (200 OK)

{
  "valid": true,
  "status": 200,
  "message": "CURP localizada exitosamente",
  "data": {
    "Curp": "ROMA900101HDFRRN01",
    "ApellidoPaterno": "RODRIGUEZ",
    "ApellidoMaterno": "MARTINEZ",
    "Nombre": "ALEJANDRO",
    "Sexo": "H",
    "FechaNacimiento": "01/01/1990",
    "Nacionalidad": "MEX",
    "DocProbatorio": "1",
    "AnioReg": "1990",
    "Foja": "12",
    "Tomo": "3",
    "Libro": "5",
    "NumActa": "345",
    "CRIP": "0900123456789",
    "NumEntidadReg": "09",
    "CveMunicipioReg": "005",
    "NumRegExtranjeros": "",
    "FolioCarta": "",
    "CveEntidadEmisora": "DF",
    "StatusCurp": "AN",
    "Historicos": []
  },
  "timestamp": "2026-09-08T18:00:00-06:00"
}

Descripción de Campos en data

Respuestas de Error

400 Bad Request (CURP Inválida o Faltante)

{
  "valid": false,
  "status": 400,
  "message": "La longitud de la CURP debe ser exactamente de 18 caracteres",
  "data": null,
  "timestamp": "2026-09-08T18:00:00-06:00"
}

401 Unauthorized (Petición directa o Firma Inválida)

{
  "valid": false,
  "status": 401,
  "message": "No autorizado: Cabeceras X-Idoo-Signature o X-Idoo-Timestamp ausentes (tráfico directo no permitido)",
  "data": null,
  "timestamp": "2026-09-08T18:00:00-06:00"
}

404 Not Found (CURP no registrada)

{
  "valid": false,
  "status": 404,
  "message": "CURP no encontrada o no registrada en RENAPO",
  "data": null,
  "timestamp": "2026-09-08T18:00:00-06:00"
}

429 Too Many Requests (Límite de tasa excedido en idoo.dev)

Controlado directamente por el gateway de idoo.dev según el plan suscrito por el consumidor.

503 Service Unavailable (Falla temporal con el proveedor)

{
  "valid": false,
  "status": 503,
  "message": "Servicio de consulta no disponible temporalmente",
  "data": null,
  "timestamp": "2026-09-08T18:00:00-06:00"
}

Tabla de Códigos de Estado HTTP