# API de verificación de identidad en Brasil: qué datos se obtienen con un CPF > Qué devuelve una API de verificación de identidad en Brasil a partir de un CPF: nombre, fecha de nacimiento, situación de registro, documento y selfie. **Publicado:** 13 de noviembre de 2026 **Autor:** Lucas Vieira **URL:** https://www.cpfhub.io/es/blog/api-verificacion-identidad-brasil --- ## 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**](/es/blog/que-es-el-cpf-de-brasil) (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**](/es). --- ## 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. ```bash curl --max-time 10 \ -H "x-api-key: TU_API_KEY" \ -H "Accept: application/json" \ https://api.cpfhub.io/cpf/00000000000 ``` ```json { "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](/es/documentacion/referencia/cpf). ### Situación de registro y año de fallecimiento La [Receita Federal](https://www.gov.br/receitafederal/pt-br/assuntos/orientacao-tributaria/cadastros/cpf) (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**](/es/consulta-cpf-receita-federal) 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. ```bash 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](/es/verificacion-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**](/es/verificacion-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](/es/documentacion/referencia/verificacion-de-identidad) describe el flujo. --- ## Empresas: el CNPJ Si también incorporas empresas (vendedores, comercios, proveedores), la [**Consulta de CNPJ**](/es/consulta-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 | Pregunta que necesitas responder | Producto | Campos principales | |---|---|---| | ¿Existe este CPF y coincide con el usuario? | Consulta Simple | `name`, `gender`, `birthDate` | | ¿El CPF está regular ante la Receita Federal? ¿El titular está vivo? | Consulta en Tiempo Real | `situation`, `deathYear`, enlace al comprobante | | ¿El usuario es mayor de edad? | Consulta Simple | `birthDate` | | ¿El usuario es el verdadero titular de la identidad? | Verificación de Identidad | prueba de vida, comparación facial, datos del documento | | ¿Existe esta empresa? | Consulta de CNPJ | datos de registro de la empresa | 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](/es/documentacion/ia/mcp), para que asistentes y agentes verifiquen un CPF directamente. La biometría es un dato sensible bajo la [LGPD](https://www.planalto.gov.br/ccivil_03/_ato2015-2018/2018/lei/l13709.htm) (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](https://www.gov.br/anpd/pt-br). 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](https://servicos.receita.fazenda.gov.br/servicos/cpf/consultasituacao/consultapublica.asp) 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](/es/precios). --- ### Lee también - [¿Qué es el CPF de Brasil? Guía para empresas extranjeras](/es/blog/que-es-el-cpf-de-brasil) - [Cómo verificar un CPF brasileño](/es/blog/como-verificar-un-cpf-brasileno) - [Requisitos de KYC en Brasil para empresas extranjeras](/es/blog/requisitos-kyc-brasil) ## 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](/es).