Consulta en Tiempo Real
La situación del CPF,
directo de la Receita Federal.
Envía el CPF (el número de identificación fiscal de personas físicas en Brasil) y la fecha de nacimiento y recibe la situación de registro directo de la Receita Federal (la autoridad tributaria federal de Brasil). Cada consulta viene con un comprobante para archivar en el contrato, el proceso o la auditoría.
50 créditos gratis al mes, sin tarjeta de crédito.
Lo que recibes
No es solo un dato. Es una prueba.
La diferencia entre saber y poder demostrarlo después.
La situación de registro
Regular, pendiente de regularización, suspendida, cancelada, nula o titular fallecido, según el registro de la Receita Federal en el momento de la consulta.
situationEl año de fallecimiento
Siempre presente, como entero o null. Solo el año, sin día ni mes. Es null cuando no hay fallecimiento registrado o cuando el valor recibido de la Receita no es válido.
deathYearEl comprobante
Una página en HTML con el resultado de la consulta, lista para archivar, y el enlace para verificar la consulta en el sitio de la Receita Federal.
validationHtmlUrlvalidationUrlEmisión y código de control
La fecha y la hora exactas de la respuesta de la Receita y el código que identifica la consulta. Demuestra que la verificación ocurrió antes de la decisión.
emissionDateemissionTimecontrolCodeLa respuesta también trae el nombre del titular, en mayúsculas, y la fecha de nacimiento (name y birthDate).
Ver la referencia completa de la respuestaSituación de registro
Seis respuestas posibles.
Una de ellas da luz verde. Las otras cinco son el motivo por el que consultas.
Regular
CPF en orden, sin pendientes.
Pendiente de regularización
Falta presentar una declaración o actualizar el registro.
Suspendida
Registro incorrecto o incompleto.
Cancelada
Cerrado por decisión administrativa, judicial o por duplicidad.
Nula
Inscripción obtenida con fraude.
Titular fallecido
Fallecimiento registrado en el registro de la Receita Federal.
Cómo funciona
Entran dos datos. Sale la prueba.
Sin certificado digital, sin e‑CNPJ (certificado digital de empresas en Brasil), sin poder electrónico y sin fila en el sitio de la Receita.
- 01
Envías dos datos
El CPF y la fecha de nacimiento del titular. Es lo que exige la Receita Federal para responder, y es todo lo que pedimos.
- 02
Consultamos la Receita al instante
Sin base intermedia y sin copia de ayer. La consulta ocurre en la Receita Federal en el momento de tu llamada.
- 03
Recibes el JSON y el comprobante
Situación de registro, año de fallecimiento, fecha y hora de emisión, código de control y el enlace al comprobante. Tu sistema decide y archiva la prueba.
El tiempo depende de la Receita Federal. Si tu flujo no puede esperar, usa la Consulta Simple en el camino crítico y esta consulta donde necesites comprobar.
Intégrala en cualquier lenguaje
La misma clave que ya usas, una ruta distinta. Ejemplos listos en diez lenguajes.
# Situación en la Receita, con comprobante oficial
curl -X POST \
'https://api.cpfhub.io/cpf/realtime' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'content-type: application/json' \
-d '{"cpf":"12345678909","birthDate":"15/06/1990"}'{
"success": true,
"data": {
"cpf": "12345678909",
"name": "FULANO DE TAL",
"birthDate": "15/06/1990",
"deathYear": null,
"situation": "REGULAR",
"emissionDate": "02/10/2026",
"emissionTime": "14:15:16",
"controlCode": "ABCD.1234.EFGH.5678",
"validationUrl": "https://servicos.receita…",
"validationHtmlUrl": "https://api.cpfhub.io/…"
}
}50 créditos gratis al mes, sin tarjeta.
Dónde usarlo
Cuando alguien te va a pedir la prueba.
Todo flujo en el que la decisión se convierte en contrato, pago o registro, y tiene que sostenerse después.
Contratación
Confirma el CPF del candidato antes de formalizar la contratación. Un CPF irregular bloquea el eSocial (el sistema del gobierno brasileño para reportes laborales y de nómina) y genera retrabajo en RR. HH.
Alquileres
Inquilino y fiador verificados antes de la firma. Una garantía con CPF irregular es una garantía que no se puede ejecutar.
Contratos y jurídico
El comprobante en HTML documenta la diligencia en la identificación de las partes, con fecha, hora y código de control.
Nómina y beneficios
La respuesta trae el año de fallecimiento en deathYear y la situación TITULAR FALECIDO (titular fallecido) cuando el registro indica un fallecimiento. Un pago indebido se frena antes de salir.
Siniestros y seguros
Confirma al asegurado en la Receita Federal antes de liberar el pago, con un registro archivable de lo consultado.
Onboarding regulado
Cuando el ente regulador pide prueba de lo que verificaste, el comprobante vale más que un log de API.
Precio
Mismo plan, mismo saldo de créditos.
La Consulta en Tiempo Real usa la misma clave, el mismo plan y el mismo saldo que la Consulta Simple. Cada consulta concluida consume 1,5 créditos por defecto, y algunos planes tienen valores distintos.
1,5 créditos
por consulta concluida, frente a 1 crédito de la Consulta Simple
0 créditos
cuando el CPF tiene formato incorrecto o la Receita Federal no responde
50
créditos gratis al mes para probar, sin tarjeta
Preguntas frecuentes
¿Cuál es la diferencia entre la Consulta Simple y la Consulta en Tiempo Real?
La Consulta Simple (GET /cpf/{cpf}) necesita solo el CPF y responde desde nuestra base y devuelve nombre, género y fecha de nacimiento. La Consulta en Tiempo Real (POST /cpf/realtime) recibe el CPF y la fecha de nacimiento en el cuerpo JSON, consulta la Receita Federal en el momento de la llamada y devuelve situación de registro, año de fallecimiento (deathYear, entero o null), código de control y comprobante en HTML. Son rutas independientes: una nunca recurre a la otra.
¿Por qué la Consulta en Tiempo Real exige la fecha de nacimiento?
Lo exige la propia Receita Federal. El servicio público de consulta solo responde cuando recibe el CPF y la fecha de nacimiento del titular juntos. Si no tienes la fecha en tu flujo, la ruta indicada es la Consulta Simple.
¿La consulta devuelve el año de fallecimiento?
Devuelve el año de fallecimiento en el campo deathYear, siempre presente, como entero o null. No devuelve día ni mes. null aparece cuando no hay fallecimiento registrado o cuando el valor recibido es inválido: debe tener 4 dígitos, estar entre 1900 y el año actual y no ser anterior al año de nacimiento.
¿Qué significa cada situación de registro?
Regular: CPF en orden. Pendiente de regularización: falta presentar una declaración o actualizar el registro. Suspendida: registro incorrecto o incompleto. Cancelada: cerrada por decisión administrativa o judicial, o por duplicidad. Nula: inscripción obtenida con fraude. Titular fallecido: fallecimiento registrado en el padrón.
¿Cómo funciona el comprobante?
La respuesta trae validationHtmlUrl, un comprobante en HTML con los datos de la consulta, fecha y hora de emisión y código de control, y validationUrl, el enlace para verificar la consulta en el sitio de la Receita Federal. Es el registro que respalda una contratación, un alquiler o un contrato en una auditoría.
¿Cuánto cuesta la Consulta en Tiempo Real?
Por defecto, 1,5 créditos por consulta concluida, frente a 1 crédito de la Consulta Simple (algunos planes tienen valores distintos). Usa el mismo saldo de tu plan, sin un paquete aparte. Un CPF con formato o dígito verificador incorrecto y las fallas de comunicación con la Receita Federal (502 y 503) no consumen crédito.
¿Cuánto tarda?
La Consulta en Tiempo Real depende del tiempo de respuesta de la Receita Federal. Si tu flujo no puede esperar, haz la llamada de forma asíncrona o usa la Consulta Simple en el camino crítico.
¿Puedo usar la Consulta en Tiempo Real en lote o por MCP?
En lote, no. POST /cpf/bulk atiende solo la Consulta Simple. Por el servidor MCP remoto (https://api.cpfhub.io/mcp), sí: expone lookup_cpf (Consulta Simple), lookup_cpf_realtime (Consulta en Tiempo Real, con CPF y fecha de nacimiento, que devuelve también deathYear, el año de fallecimiento, entero o null) y get_quota_info (saldo). No hay una tool de lote en el MCP. Para volumen en la Consulta en Tiempo Real, escribe a nuestro equipo por WhatsApp o a contato@cpfhub.io.
¿Necesito otra cuenta u otra clave?
No. Es la misma cuenta, la misma x-api-key, el mismo plan y el mismo saldo de créditos que ya usas en GET /cpf/{cpf}.
Situación de registro
en tiempo real.
- 50 créditos gratis al mes
- Sin tarjeta de crédito
- Atención 24 h por WhatsApp