Documentacion API

API de DescifraMX

Integra validacion de CURP y RFC en minutos. Esta guia incluye base URL, endpoints, cURL y codigos de error.

Base URL

https://deciframx.vercel.app

Rate limit

100 peticiones por hora / IP

Headers: X-RateLimit-* y Retry-After

CORS

Access-Control-Allow-Origin: *

Compatible con frontend externo

OpenAPI JSON

Ver especificacion

Endpoints

Validar CURP (POST)

POST/api/validate/curp

Valida estructura, campos y digito verificador del CURP.

Body

{"curp":"HEGJ850101HDFRLN08"}

Ejemplo cURL

curl -X POST "https://deciframx.vercel.app/api/validate/curp" \
  -H "Content-Type: application/json" \
  -d "{\"curp\":\"HEGJ850101HDFRLN08\"}"

Validar CURP (GET)

GET/api/validate/curp/{curp}

Misma validacion del endpoint POST, enviando el CURP en ruta.

Body

No aplica

Ejemplo cURL

curl "https://deciframx.vercel.app/api/validate/curp/HEGJ850101HDFRLN08"

Validar RFC (POST)

POST/api/validate/rfc

Valida RFC de persona fisica o moral (12 o 13 caracteres).

Body

{"rfc":"HEGJ850101ABC"}

Ejemplo cURL

curl -X POST "https://deciframx.vercel.app/api/validate/rfc" \
  -H "Content-Type: application/json" \
  -d "{\"rfc\":\"HEGJ850101ABC\"}"

Catalogo de estados

GET/api/states

Devuelve codigos y nombres de entidades para CURP.

Body

No aplica

Ejemplo cURL

curl "https://deciframx.vercel.app/api/states"

Quick start (JavaScript)

const response = await fetch("https://deciframx.vercel.app/api/validate/curp", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ curp: "HEGJ850101HDFRLN08" }),
});

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

Playground API

Prueba endpoints en vivo desde esta pagina y revisa status, headers y respuesta.

Status

Aun sin ejecutar

Headers

{}

Respuesta JSON

{ }

Codigos de error

CodigoHTTPDescripcion
INVALID_FORMAT400 / 415JSON malformado o content-type invalido.
MISSING_FIELD400Falta el campo obligatorio en body.
INVALID_LENGTH400Longitud invalida de CURP o RFC.
INVALID_DATE400Fecha de nacimiento invalida.
INVALID_STATE400Codigo de estado no reconocido en CURP.
INVALID_GENDER400Sexo invalido en CURP (H o M).
RATE_LIMIT_EXCEEDED429Limite de peticiones excedido por IP.