RENAPO1 tokenPOST

PDF CURP por CURP

Descarga el PDF oficial de la CURP emitido por RENAPO codificado en base64 a partir de una CURP. Útil para que el usuario obtenga su comprobante directamente en flujos de onboarding digital.

Endpoint

POSThttps://api.datosnonstop.com/v1/renapo/pdf-curp

Parámetros

json

{
  "curp": "ROPG750823MGRDZL09"
}

ParámetroTipoRequeridoDescripción

curpstringSíCURP de 18 caracteres a consultar

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-curp \
  -H "x-api-key: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"curp":"ROPG750823MGRDZL09"}'

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": "9c5d034a6f0c3e7b1b49d263",
  "status": "found",
  "curp": "ROPG750823MGRDZL09",
  "pdfBase64": "JVBERi0xLjUKJafj8"
}

Respuestas en error

JSON

400 Bad Request

[
  {
    "type": "format",
    "message": "El formato del campo es inválido",
    "field": "curp"
  }
]

Campos

Campos de entrada

CampoTipoDescripción

curpstringCadena alfanumérica de 18 caracteres que identifica de forma única a una persona ante RENAPO.

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 consultada (18 caracteres).

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.

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ó la CURP en RENAPO. La respuesta incluye el PDF oficial codificado en base64.

not_foundLa CURP no fue encontrada en el sistema de RENAPO. La respuesta incluye el campo message con el detalle.

Histórico

Endpoint

GEThttps://api.datosnonstop.com/v1/renapo/pdf-curp/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": "9c5d034a6f0c3e7b1b49d263",
  "status": "found",
  "curp": "ROPG750823MGRDZL09",
  "pdfBase64": "JVBERi0xLjUKJafj8"
}

Respuestas en error

JSON

404 Not Found

[
  {
    "type": "not_found",
    "message": "el id no fue encontrado en el historico"
  }
]

Sandbox

Endpoint

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

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

curl

curl -X POST https://sandbox.api.datosnonstop.com/v1/renapo/pdf-curp \
  -H "x-api-key: tu_api_key_sandbox" \
  -H "Content-Type: application/json" \
  -d '{"curp":"ROPG750823MGRDZL09"}'

Casos de prueba

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

CasoCURP

Caso exitoso — EncontradoROPG750823MGRDZL09

Caso exitoso — No encontradoXXXX900101HXXXXX01

Sin tokensAAAB801109HAAABS04

Error internoBBBC691225MBBBBV05

Unavailable serviceDDDE540630HDDDDF06

Endpoint histórico

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

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

curl

curl https://sandbox.api.datosnonstop.com/v1/renapo/pdf-curp/historico/9c5d034a6f0c3e7b1b49d263 \
  -H "x-api-key: tu_api_key_sandbox"

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 9c5d034a6f0c3e7b1b49d263.

Casoid

Caso exitoso9c5d034a6f0c3e7b1b49d263

No encontrado0000000000000000ffffffff

Fuera de rango1111111111111111aaaaaaaa

Error interno2222222222222222bbbbbbbb

Empezar gratis →