Documentación de la API

Valida una CURP, coteja los datos de la persona si los envías y, con verificar, la consulta en el registro de RENAPO.

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 internas con que RENAPO forma la CURP —que no son públicas— 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
}

Calcula la CURP a partir de los datos de la persona: nombres, apellidos, fecha de nacimiento, sexo y entidad de nacimiento. Se calcula al instante con las reglas publicadas de RENAPO, sin consultar el registro. Consume 1 token.

Las posiciones 1 a 16 salen de los datos. La 17 (el diferenciador de la homoclave) la asigna RENAPO para distinguir homónimos y no se puede deducir: asumimos 0 para nacidos antes de 2000 y A desde 2000, que es lo que el registro asigna cuando no hay homónimo, y la respuesta lo indica con diferenciadorAsumido. El dígito verificador se calcula sobre esa suposición. Para confirmar que la CURP existe, verifícala con POST /api/v1/curp.

segundoApellido es opcional: omitido o null significa que la persona no tiene segundo apellido. Si falta un campo obligatorio o uno no se puede convertir en caracteres de la CURP (una fecha que no existe, un sexo distinto de H/M, una entidad ambigua como «México»), la petición se rechaza con 400 INVALID_REQUEST, el campo en field, y no consume token.

Ejemplo

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

Respuesta

{
  "success": true,
  "data": {
    "curp": "PEGJ850101HDFRMN02",
    "raiz": "PEGJ850101HDFRMN",
    "diferenciador": "0",
    "diferenciadorAsumido": true,
    "digitoVerificador": "2",
    "fechaNacimiento": "1985-01-01",
    "sexo": "H",
    "claveEntidad": "DF",
    "entidad": "Ciudad de México"
  },
  "tokens_remaining": 431
}

Calcula el RFC con homoclave de una persona física a partir de sus nombres, apellidos y fecha de nacimiento. Se calcula al instante con el algoritmo publicado del SAT, sin consultar al SAT. Consume 1 token.

Las posiciones 1 a 10 salen del nombre y la fecha. La homoclave (posiciones 11 y 12) y el dígito verificador se calculan con las tablas del SAT sobre el nombre completo, pero el SAT asigna otra homoclave cuando dos contribuyentes coinciden o si tiene el nombre registrado de otra forma; la respuesta lo indica con homoclaveAsumida. Un RFC calculado no confirma que la persona esté inscrita en el SAT.

segundoApellido es opcional: omitido o null significa que la persona no tiene segundo apellido. En lugar de fechaNacimiento puedes mandar curp y tomamos la fecha de ahí (solo la fecha). Si mandas las dos, deben coincidir. Si falta un campo obligatorio o uno no se puede convertir en caracteres del RFC (un nombre sin letras, una fecha que no existe, una CURP inválida o cuya fecha no coincide), la petición se rechaza con 400 INVALID_REQUEST, el campo en field, y no consume token.

Modo solo CURP: si mandas curp y destinationId sin nombres ni primerApellido, primero consultamos en RENAPO el nombre registrado para esa CURP y calculamos el RFC con él. La respuesta es 202 con data: null y verificacion.job_id; el RFC llega a tu destino en el evento curp.verification.* (producto: "calculo-rfc", rfc, rfcRaiz, rfcHomoclave, rfcDigitoVerificador) y en GET /api/v1/curp/verificacion/{job_id} como rfc. Cuesta 1 token, igual que una verificación, y se reembolsa (reembolsado: "true") si la CURP no se encuentra, el registro no devuelve nombre o la consulta no termina. Si no podemos consultar el registro en ese momento, responde 503 sin cobrar.

Ejemplo

curl -X POST https://verificarcurp.com/api/v1/rfc/calcular \
  -H "X-API-Key: curp_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "nombres": "EMMA",
    "primerApellido": "GOMEZ",
    "segundoApellido": "DIAZ",
    "fechaNacimiento": "1956-12-31"
  }'

Respuesta

{
  "success": true,
  "data": {
    "rfc": "GODE561231GR8",
    "raiz": "GODE561231",
    "homoclave": "GR",
    "homoclaveAsumida": true,
    "digitoVerificador": "8",
    "fechaNacimiento": "1956-12-31"
  },
  "tokens_remaining": 431
}

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
}

curl -X POST https://verificarcurp.com/api/v1/capture-links \
  -H "X-API-Key: curp_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "destinationId": "<id de tu destino>",
    "reference": "reserva-8841",
    "persona": {
      "nombres": "Julio",
      "primerApellido": "Pérez",
      "fechaNacimiento": "1985-01-01"
    }
  }'

• destinationId es requerido. persona (opcional) son los datos de la reservación: si la CURP no coincide, a tu cliente se le pide acudir a recepción, sin mostrarle tus datos. Con askGuestPersona: true tu cliente también escribe su nombre, primer apellido y fecha de nacimiento. reference (hasta 80 caracteres) viaja en la entrega.
• Un solo uso: 15 minutos para abrirlo y, ya abierto, 15 minutos para responder.
• La url solo se devuelve en esta respuesta; trátala como una credencial y no la guardes en logs.
• Crear el enlace no cuesta. Cada respuesta cuesta 1 token, también un no_coincide, igual que en POST /api/v1/curp. El enlace admite 3 intentos, así que un cliente que se equivoca puede costar hasta 3 tokens. Si la entrega falla, el token se devuelve.
• Solo una CURP válida y que coincide llega a tu destino. Hasta 20 enlaces vivos a la vez (400 TOO_MANY_LIVE_LINKS); un destino inexistente o pausado: 400 DESTINATION_NOT_FOUND.

Respuesta (201)

{
  "success": true,
  "id": "clx_enlace_456",
  "url": "https://verificarcurp.com/c/…",
  "reference": "reserva-8841",
  "documentType": null,
  "requireBack": false,
  "askGuestPersona": false,
  "expiresAt": "2026-09-30T18:15:00.000Z"
}