RENAPO1 tokenPOST

PDF CURP por Datos Generales

Descarga el PDF oficial de la CURP emitido por RENAPO codificado en base64 a partir de los datos personales: nombres, apellidos, fecha de nacimiento, sexo y entidad de registro. Útil cuando el usuario no recuerda su CURP en flujos de onboarding digital.

Endpoint

POSThttps://api.datosnonstop.com/v1/renapo/pdf-datos-generales

Parámetros

json

{
  "claveEntidad": "YN",
  "fechaNacimiento": "1987-07-25",
  "nombres": "USUARIO EDUARDO",
  "primerApellido": "RAMIREZ",
  "segundoApellido": "VAZQUEZ",
  "sexo": "H"
}

ParámetroTipoRequeridoDescripción

claveEntidadstringSíClave de 2 caracteres de la entidad de nacimiento.

fechaNacimientostringSíFecha de nacimiento en formato ISO YYYY-MM-DD.

nombresstringSíNombres de pila tal como aparecen en el acta de nacimiento.

primerApellidostringSíPrimer apellido de la persona.

segundoApellidostringNoSegundo apellido de la persona. Opcional cuando la persona no tiene segundo apellido.

sexostringSíClave del sexo registrado: H, M o X.

Ejemplo rápido

Coloca tu API key en el header x-api-key y agrega el header Content-Type: application/json para enviar el body como JSON.

curl

curl -X POST https://api.datosnonstop.com/v1/renapo/pdf-datos-generales \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"claveEntidad":"YN","fechaNacimiento":"1987-07-25","nombres":"USUARIO EDUARDO","primerApellido":"RAMIREZ","segundoApellido":"VAZQUEZ","sexo":"H"}'

Tip

¿Sabías que al pegar un cURL en Postman te crea automáticamente la llamada con todos los elementos?

Token

Cada consulta consume tokens. Lo que no uses, lo conservas — tu saldo se acumula sin fecha de vencimiento ni reinicios. Puedes consultarlo en cualquier momento desde el dashboard o directamente en el header de cada respuesta x-tokens-remaining.

Respuesta

JSON

200 OK

{
  "id": "ad6e145b7g1d4f8c2c5ae374",
  "status": "found",
  "curp": "RAVU870725HYNMZS09",
  "pdfBase64": "JVBERi0xLjUKJafj8"
}

Respuestas en error

JSON

400 Bad Request

{
  "error": "empty_field",
  "message": "El campo 'primerApellido' es requerido",
  "field": "primerApellido"
}

Campos

Campos de entrada

CampoTipoDescripción

claveEntidadstringClave de 2 caracteres de la entidad federativa donde se registró el nacimiento. Ver catálogo Clave de entidad.

fechaNacimientostringFecha de nacimiento en formato ISO YYYY-MM-DD.

nombresstringNombres de pila tal como aparecen en el documento probatorio. Aceptado en mayúsculas o minúsculas; RENAPO normaliza el valor.

primerApellidostringPrimer apellido de la persona.

segundoApellidostringSegundo apellido de la persona. Opcional cuando la persona no tiene segundo apellido registrado.

sexostringClave del sexo registrado: H, M o X. Ver catálogo Sexo (entrada).

Campos de respuesta

CampoTipoDescripción

idstringIdentificador interno de la consulta, útil para soporte y trazabilidad.

statusstringResultado de la consulta del PDF de la CURP en RENAPO. Ver catálogo Status.

curpstringCURP localizada en RENAPO a partir de los datos enviados (18 caracteres). Solo está presente cuando status es found.

pdfBase64stringPDF oficial de la CURP emitido por RENAPO, codificado en base64. Decodifícalo y guárdalo con extensión .pdf para visualizarlo. Solo está presente cuando status es found.

claveEntidadstringClave de entidad enviada en la consulta. Solo está presente en respuestas not_found. Ver catálogo Clave de entidad.

fechaNacimientostringFecha de nacimiento enviada en la consulta. Solo está presente en respuestas not_found.

nombresstringNombres enviados en la consulta. Solo está presente en respuestas not_found.

primerApellidostringPrimer apellido enviado en la consulta. Solo está presente en respuestas not_found.

segundoApellidostringSegundo apellido enviado en la consulta. Solo está presente en respuestas not_found.

sexostringClave del sexo enviada en la consulta. Solo está presente en respuestas not_found. Ver catálogo Sexo (entrada).

messagestringDetalle del motivo cuando status es not_found. Solo está presente en respuestas not_found.

Catálogos

Tablas de referencia para los valores de los campos enumerados en la sección anterior.

Status

Valores posibles del campo status.

ValorDescripción

foundSe localizó una CURP que coincide con los datos enviados. La respuesta incluye el PDF oficial codificado en base64.

not_foundNo se encontró una CURP que coincida con los datos enviados en RENAPO. La respuesta incluye el campo message con el detalle.

Clave de entidad

Catálogo de claves de 2 caracteres usadas en el campo claveEntidad para identificar la entidad federativa de nacimiento.

ClaveDescripción

ASAGUASCALIENTES

BCBAJA CALIFORNIA

BSBAJA CALIFORNIA SUR

CCCAMPECHE

CLCOAHUILA

CMCOLIMA

CSCHIAPAS

CHCHIHUAHUA

DFCIUDAD DE MÉXICO

DGDURANGO

GTGUANAJUATO

GRGUERRERO

HGHIDALGO

JCJALISCO

MCESTADO DE MÉXICO

MNMICHOACÁN

MSMORELOS

NTNAYARIT

NLNUEVO LEÓN

OCOAXACA

PLPUEBLA

QTQUERÉTARO

QRQUINTANA ROO

SPSAN LUIS POTOSÍ

SLSINALOA

SRSONORA

TCTABASCO

TSTAMAULIPAS

TLTLAXCALA

VZVERACRUZ

YNYUCATÁN

ZSZACATECAS

NENACIDO EN EL EXTRANJERO

Sexo (entrada)

Claves aceptadas en el campo sexo de la consulta.

ClaveDescripción

HHOMBRE

MMUJER

XNO BINARIO

Histórico

Endpoint

GEThttps://api.datosnonstop.com/v1/renapo/pdf-datos-generales/historico/{id}

El {id} corresponde al campo id devuelto en la respuesta de la consulta principal.

Si necesitas la lista completa de elementos almacenados, accede a tu dashboard.

La respuesta está sujeta al tiempo de almacenamiento de tu plan. Si requieres más tiempo, cambia de plan en tu dashboard.

Respuesta

JSON

200 OK

{
  "id": "ad6e145b7g1d4f8c2c5ae374",
  "status": "found",
  "curp": "RAVU870725HYNMZS09",
  "pdfBase64": "JVBERi0xLjUKJafj8"
}

Respuestas en error

JSON

404 Not Found

{
  "error": "not found",
  "message": "el id no fue encontrado en el historico"
}

Sandbox

Endpoint

POSThttps://sandbox.api.datosnonstop.com/v1/renapo/pdf-datos-generales

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

Casos de prueba

Si envías un valor que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de RAMIREZ.

CasoCampoprimerApellido

Caso exitoso — EncontradoprimerApellidoRAMIREZ

Caso exitoso — No encontradoprimerApellidoNOEXISTE

Empty fieldprimerApellidoEMPTY

Invalid formatclaveEntidadZZ

Sin tokensprimerApellidoSINTOKENS

Error internoprimerApellidoERROR

Unavailable serviceprimerApellidoUNAVAILABLE

Endpoint histórico

GEThttps://sandbox.api.datosnonstop.com/v1/renapo/pdf-datos-generales/historico/{id}

Para llamar al sandbox necesitas una API key de sandbox que puedes generar en el dashboard.

Casos de prueba histórico

Si envías un valor de id que no esté en la lista, el sandbox devuelve automáticamente una respuesta exitosa con la misma estructura que la de ad6e145b7g1d4f8c2c5ae374.

Casoid

Caso exitosoad6e145b7g1d4f8c2c5ae374

No encontrado0000000000000000ffffffff

Fuera de rango1111111111111111aaaaaaaa

Error interno2222222222222222bbbbbbbb

Empezar gratis →