POST/v1/curp/download

Descargar constancia de CURP

Genera y descarga la constancia oficial de CURP emitida por RENAPO en formato PDF.

Este endpoint es síncrono: bloquea hasta que el PDF esté listo y devuelve 200 con el archivo en base64 dentro de data.pdf.

Decodificar el PDF en Node.js:

const { data } = await res.json();
const buf = Buffer.from(data.pdf, 'base64');
fs.writeFileSync('constancia.pdf', buf);

El header x-async no está soportado en este endpoint.

Servidoreditable

API Key con prefijo ck_live_ (producción) o ck_test_ (pruebas)

curp*string

CURP de 18 caracteres en mayúsculas. Codifica iniciales, fecha de nacimiento, sexo y entidad federativa.

curl -X POST 'https://api.curpify.mx/v1/curp/download' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"curp":"HEGG560427MVZRRL04"}'

Respuestas del esquema

Constancia generada — PDF en base64 dentro de `data.pdf`.

{
  "data": {
    "pdf": "JVBERi0xLjQK..."
  },
  "meta": {
    "requestId": "LM8K2X9P4Q",
    "timestamp": "2026-06-11T15:30:00.000Z",
    "version": "1",
    "source": "provider",
    "cached": false
  }
}