API de verificación de identidad en Brasil: qué datos se obtienen con un CPF

Introducción

Con un CPF, una API de verificación de identidad en Brasil puede devolverte el nombre completo, el género y la fecha de nacimiento del titular, y, con una consulta más profunda, su situación de registro ante la Receita Federal y el año de fallecimiento cuando lo hay. Para confirmar que quien está del otro lado de la pantalla es el titular, se suman la lectura del documento, la prueba de vida y la comparación facial.

Brasil no tiene una API pública única de identidad. La verificación gira en torno al CPF (el número de identificación fiscal de personas físicas en Brasil) y a los datos vinculados a él. A continuación verás qué dato sirve para qué, y cómo se reparte entre los productos de CPFHub.io.

Los datos que puedes verificar con un CPF

Nombre, género y fecha de nacimiento

Es la verificación más común. A partir de un CPF, la Consulta Simple devuelve el nombre completo, el género y la fecha de nacimiento del titular. Tú los comparas con lo que escribió el usuario:

• Un CPF real con otro nombre u otra fecha de nacimiento apunta a una identidad prestada o robada.
• Un CPF que no existe apunta a un número inventado que pasó el algoritmo de dígitos verificadores.

curl --max-time 10 \
  -H "x-api-key: TU_API_KEY" \
  -H "Accept: application/json" \
  https://api.cpfhub.io/cpf/00000000000

{
  "success": true,
  "data": {
    "cpf": "00000000000",
    "name": "Fulano de Tal",
    "nameUpper": "FULANO DE TAL",
    "gender": "M",
    "birthDate": "15/06/1990",
    "day": 15,
    "month": 6,
    "year": 1990
  }
}

Un CPF no encontrado devuelve 404 y no consume créditos. Los campos están en la referencia del endpoint de CPF.

Situación de registro y año de fallecimiento

La Receita Federal (la autoridad tributaria federal de Brasil) mantiene una situación de registro para cada CPF: regular, pendiente de regularización, suspendida, cancelada, nula o titular fallecido. La Consulta en Tiempo Real consulta la Receita Federal en el momento de la llamada y devuelve:

• el nombre y la fecha de nacimiento del titular,
• la situación de registro (situation),
• el año de fallecimiento, cuando lo hay (deathYear),
• un enlace al comprobante emitido por la Receita Federal, útil para auditoría.

Necesita el CPF y la fecha de nacimiento del titular, un requisito de la propia Receita Federal. Úsala cuando el riesgo lo justifique: crédito, retiros, onboarding regulado o la confirmación de que un cliente sigue vivo.

curl --max-time 60 -X POST https://api.cpfhub.io/cpf/realtime \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cpf": "00000000000", "birthDate": "15/06/1990"}'

Edad

Como las consultas devuelven la fecha de nacimiento, la misma llamada te dice si el titular del CPF es mayor de edad. Junto con la coincidencia del nombre, esa es la base de la verificación de edad, cada vez más pedida por plataformas a las que pueden acceder menores.

Más allá del CPF: documento y biometría

Una consulta de CPF prueba que una identidad existe y coincide. No prueba que quien la escribe sea esa persona. Para eso, los flujos regulados suman:

• Prueba de vida: el usuario es una persona real frente a la cámara, no una foto, una pantalla ni una máscara.
• Comparación facial: la selfie coincide con la foto del documento de identidad.
• Lectura del documento: nombre, número de documento, CPF y fecha de nacimiento se leen del RG, de la CNH (la licencia de conducir) o del pasaporte, y se cruzan con los datos del CPF.

La Verificación de Identidad de CPFHub.io hace estos tres pasos con la misma clave de API. Es la capa para la apertura de cuentas en fintechs y exchanges, los retiros y otros flujos de alto riesgo. La referencia de la Verificación de Identidad describe el flujo.

Empresas: el CNPJ

Si también incorporas empresas (vendedores, comercios, proveedores), la Consulta de CNPJ devuelve los datos de registro a partir del CNPJ (el número de identificación fiscal de empresas en Brasil), la base del KYB.

Cómo elegir la verificación correcta

Para la mayoría de las plataformas, un buen punto de partida es la Consulta Simple en el registro de todos los usuarios y la Verificación de Identidad solo cuando el usuario llega a una acción de riesgo, como su primer retiro.

Notas de integración

• La clave de API se queda en tu servidor. El frontend llama a una ruta propia de tu backend, y esa ruta llama a la API con el header x-api-key leído de una variable de entorno (CPFHUB_API_KEY).
• Maneja los dos formatos de error. Los errores de consulta devuelven un objeto error con message, y los de autenticación devuelven error como texto. Los mensajes de la API están en portugués.
• Respeta los límites por minuto. Un 429 llega con el header Retry-After y no se cobra.
• Agentes de IA: la API también está disponible por un servidor MCP, para que asistentes y agentes verifiquen un CPF directamente.

La biometría es un dato sensible bajo la LGPD (la ley brasileña de protección de datos), así que indica la base legal (por lo general, la prevención de fraude) en tu aviso de privacidad. La autoridad de control es la ANPD. Si tu empresa también está sujeta a una ley de datos en tu país, revisa con tu equipo legal cómo conviven las dos.

Preguntas frecuentes

¿Hay una API gratuita del gobierno para verificar un CPF?

No para verificaciones automatizadas. La Receita Federal ofrece una página pública de consulta para un CPF a la vez, con captcha, que no sirve para flujos de registro. La verificación automatizada pasa por una API de pago.

¿Qué datos devuelve una consulta de CPF?

La Consulta Simple de CPFHub.io devuelve el nombre, el género y la fecha de nacimiento del titular. La Consulta en Tiempo Real suma la situación de registro ante la Receita Federal, el año de fallecimiento cuando lo hay y el enlace al comprobante.

¿Puedo verificar una identidad sin selfie?

Sí, con un nivel de seguridad menor. Una consulta de CPF con coincidencia de nombre y fecha de nacimiento confirma que la identidad existe y coincide. Solo el documento y la biometría muestran que el usuario es el verdadero titular.

¿Cuánto cuesta una consulta?

El plan Gratis incluye 50 créditos al mes, sin tarjeta. Un CPF no encontrado no consume créditos. Los planes de pago están en precios.

Lee también

• ¿Qué es el CPF de Brasil? Guía para empresas extranjeras
• Cómo verificar un CPF brasileño
• Requisitos de KYC en Brasil para empresas extranjeras

Conclusión

Una API de verificación de identidad en Brasil no es una sola verificación, sino un conjunto anclado en el CPF: existencia y coincidencia, situación ante la Receita Federal, edad, y documento con biometría para los flujos de mayor riesgo. Elige la verificación más liviana que cubra tu riesgo y sube de nivel solo cuando la acción del usuario lo pida.

Pruébala con 50 créditos gratis y sin tarjeta en cpfhub.io.