Documentación de la API

Introducción

La API de Verificar CURP te permite validar el formato de una CURP y cotejarla contra los datos que ya tienes de la persona, de manera programática. Todo se calcula con la CURP misma: no consultamos ningún registro.

URL Base: https://verificarcurp.com/api/v1

Para agentes de IA: /llms.txt es el índice del servicio y /llms-full.txt contiene endpoints, campos, precios y preguntas frecuentes en un solo archivo de texto.

Obtén tu API key

Crea tu cuenta aquí mismo, sin salir de esta página, y genera tu API key en menos de un minuto.

20 tokens gratis al crear tu cuenta: suficientes para probar la API con tus propios documentos antes de comprar el primer paquete.

¿Ya tienes cuenta? Ve a tus API keys.

O continúa con

Autenticación

Todas las peticiones a la API requieren autenticación mediante una API key. Incluye tu API key en el header X-API-Key de cada petición.

curl -H "X-API-Key: curp_tu_api_key" \
  https://verificarcurp.com/api/v1/balance

Puedes generar y administrar tus API keys desde el dashboard.

Endpoints

POST/api/v1/curp

Valida una CURP y, si envías datos de la persona, los coteja contra ella.

El objeto persona es opcional: sin él la respuesta es sólo la validación. Cada campo que mandas se coteja por separado, y un campo cuya comparación dependería de las reglas del registro —que no tenemos— responde indeterminado en lugar de adivinar.

Ejemplo

curl -X POST https://verificarcurp.com/api/v1/curp \
  -H "X-API-Key: curp_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "curp": "PEGJ850101HDFRRL04",
    "persona": {
      "nombres": "JULIO",
      "primerApellido": "PEREZ",
      "segundoApellido": "GARZA",
      "fechaNacimiento": "1985-01-01",
      "sexo": "H",
      "entidad": "CDMX"
    }
  }'

Respuesta

{
  "success": true,
  "data": {
    "curp": "PEGJ850101HDFRRL04",
    "valida": true,
    "razon": null,
    "fechaNacimiento": "1985-01-01",
    "sexo": "H",
    "claveEntidad": "DF",
    "entidad": "Ciudad de México",
    "cotejo": "coincide",
    "cotejoCampos": {
      "nombres": "coincide",
      "primerApellido": "coincide",
      "segundoApellido": "coincide",
      "fechaNacimiento": "coincide",
      "sexo": "coincide",
      "entidad": "coincide"
    }
  },
  "tokens_remaining": 19
}
GET/api/v1/balance

Obtiene el saldo actual de tokens de tu cuenta.

Ejemplo

curl https://verificarcurp.com/api/v1/balance \
  -H "X-API-Key: curp_tu_api_key"

Respuesta

{
  "success": true,
  "balance": 20
}

Códigos de error

CódigoHTTPDescripción
MISSING_API_KEY401No se proporcionó API key
INVALID_API_KEY401API key inválida o revocada
INVALID_REQUEST400El cuerpo de la petición no tiene la forma esperada; no consume token
INSUFFICIENT_TOKENS402Saldo insuficiente de tokens
INTERNAL_ERROR500Error interno del servidor

Campos

La respuesta devuelve los siguientes campos:

curp

La CURP que enviaste, normalizada a mayúsculas

valida

Si la CURP está bien formada

razon

Por qué no es válida, cuando no lo es

fechaNacimiento

Fecha de nacimiento que codifica la CURP

sexo

Sexo que codifica la CURP (H o M)

claveEntidad

Clave de la entidad de nacimiento que codifica la CURP

entidad

Entidad de nacimiento que codifica la CURP

cotejo

Resultado del cotejo: coincide, no_coincide o indeterminado

cotejoCampos

Resultado del cotejo campo por campo: nombres, apellidos, fecha, sexo y entidad

Límites y cuotas

  • Cada respuesta consume 1 token, incluida una CURP mal formada y un cotejo que no coincide: la respuesta es el producto
  • Una petición mal formada se rechaza con 400 y no consume token
  • Si la respuesta falla por un error nuestro, el token se reembolsa automáticamente
  • Todo se calcula con la CURP misma: no consultamos ningún registro, y la respuesta no devuelve datos personales que no hayas enviado
  • Los tokens no expiran