API de Consulta de CPF en la Receita Federal
En CPF.CNPJ, simplificamos y agilizamos el acceso a información esencial de personas físicas y jurídicas.
Por qué consultar el CPF directamente en la Receita Federal
El CPF es el identificador oficial de las personas físicas en Brasil, pero el número, por sí solo, no comprueba nada: dígitos válidos en el algoritmo de verificación no significan que el CPF exista, esté regular o pertenezca a la persona informada. Sin consultar la base de la Receita Federal, las empresas aceptan registros con CPF inexistente, de terceros o en situación irregular, abriendo brecha para fraude de identidad, fraude documental e incumplimiento de obligaciones de prevención de fraudes en el onboarding.
La consulta devuelve la situación registral del CPF, que puede estar Regular, Pendiente de Regularización, Suspendida, Cancelada, Nula o indicar Titular Fallecido. Cada situación tiene efecto práctico: un CPF Suspendido o Pendiente impide la emisión de facturas y contrataciones; un CPF Cancelado o de titular fallecido usado en un registro nuevo es fuerte indicio de fraude. Validar esa situación antes de aprobar al cliente es lo que separa un onboarding seguro de un pasivo de fraude y compliance.
Hacer esto manualmente no escala. Los equipos que procesan miles de registros por día no logran verificar CPF por CPF en el sitio de la Receita, que además exige captcha y no ofrece respuesta programática. Una API de consulta de CPF resuelve el cuello de botella: integra la verificación directamente en el flujo de registro, devuelve la situación registral en tiempo real y permite automatizar la decisión de aprobar, rechazar o enviar el caso a revisión humana.
Qué entrega la API de Consulta de CPF
1. Nombre y situación registral oficiales
La API devuelve el nombre completo del titular y la situación registral del CPF exactamente como constan en la base de la Receita Federal: Regular, Pendiente de Regularización, Suspendida, Cancelada, Nula o Titular Fallecido. Con esos datos confrontas el nombre declarado por el cliente con el nombre oficial y bloqueas automáticamente los CPF que no estén regulares.
2. Fecha de nacimiento según permiso
Cuando el paquete contratado y las reglas de uso lo permiten, la respuesta incluye la fecha de nacimiento asociada al CPF. Esto viabiliza verificaciones adicionales como comprobación de mayoría de edad (18+) y cross-matching de la fecha declarada contra la fecha oficial, reforzando la prevención de fraude de identidad sintética.
3. Respuesta en tiempo real (D+0)
La consulta se hace en la fuente oficial y responde en tiempo real, sin caché desactualizada. La situación registral reflejada es la del momento de la consulta (D+0), garantizando que las decisiones de onboarding usen el estado actual del CPF y no una instantánea antigua.
4. REST/JSON con autenticación por token
La integración es una API REST que devuelve JSON, autenticada por un token enviado en el encabezado de la solicitud. No hay captcha, no hay dependencia de pantalla del gobierno: basta una llamada HTTP desde tu backend para recibir los datos estructurados y tratarlos en tu flujo.
Cómo integrar la Consulta de CPF
La consulta es una llamada HTTP GET autenticada por token Bearer. Envía el CPF como parámetro y recibe la situación registral en JSON. Ejemplo con cURL:
# Consulta de CPF na Receita Federal via API
curl -X GET "https://api.cpfcnpj.com.br/SEU_TOKEN/9/12345678909" \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Accept: application/json"
# Resposta (JSON)
{
"status": 1,
"cpf": "123.456.789-09",
"nome": "JOSE DA SILVA",
"situacao_cadastral": "REGULAR",
"data_nascimento": "1990-05-14",
"data_consulta": "2026-06-02T10:32:11Z"
}Trata el campo situacao_cadastral en tu backend: aprueba solo los CPF REGULAR, bloquea CANCELADA, NULA y TITULAR FALECIDO, y envía PENDENTE o SUSPENSA a revisión. La referencia completa de endpoints, paquetes y códigos de retorno está en https://www.cpfcnpj.com.br/dev/.
Qué esperar de la API de Consulta de CPF
- Latencia baja: Respuesta media entre 0,4 y 2 segundos por consulta de CPF
- Uptime 99,9%: Disponibilidad del servicio para integrar la consulta en tu onboarding
- Fuente oficial Receita Federal: Situación registral consultada en la base oficial, sin dato intermediario
- Cobertura nacional: Consulta de cualquier CPF emitido en Brasil, en tiempo real (D+0)
