Consulta en Tiempo Real
La situación del CPF,
directo de la Receita Federal.
Informas el CPF (el número de identificación fiscal de personas físicas en Brasil) y la fecha de nacimiento. La consulta se hace en tiempo real en la Receita Federal (la autoridad tributaria federal de Brasil) y devuelve la situación de registro, el año de fallecimiento, la fecha y hora de emisión y un comprobante en HTML para archivar en el contrato, el proceso o la auditoría.
1,5 créditos por consulta exitosa. La misma clave, el mismo plan, el mismo saldo.
Lo que recibes
No es solo un dato. Es una prueba.
La diferencia entre saber y poder demostrarlo después.
La situación del CPF
Regular, suspendido, cancelado, nulo, pendiente o titular fallecido. Directo del registro de la Receita Federal, no de una base intermedia.
El año de fallecimiento
El campo deathYear siempre viene, como entero o null. Es solo el año, sin día ni mes. null aparece cuando no hay fallecimiento registrado o cuando el valor recibido no es válido.
El comprobante en HTML
Una página con el resultado de la consulta, lista para archivar en un proceso, un contrato o una auditoría, más el enlace para validarlo en el sitio de la Receita Federal.
Fecha y hora de emisión
El momento exacto en que respondió la Receita Federal. Es lo que demuestra que la verificación se hizo antes de la decisión.
El código de control
El código que identifica la consulta en la Receita Federal y permite verificar el resultado en el sitio de la Receita.
Situació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.
El precio
Sin paquete aparte.
Sale del mismo saldo.
En CPFHub.io, la Consulta en Tiempo Real usa la misma clave, el mismo plan y el mismo saldo de créditos que la Consulta Simple. Cada consulta exitosa consume 1,5 créditos por defecto (algunos planes tienen valores diferentes). Cambias de ruta sin cambiar de contrato.
1,5 créditos
por consulta exitosa, frente a 1 crédito de la Consulta Simple
0 créditos
cuando la Receita Federal está fuera de servicio o la fecha de nacimiento no coincide
50
créditos gratis al mes para probar, 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.
RR. HH. y ContrataciónAlquileres
Inquilino y fiador verificados antes de la firma. Una garantía con CPF irregular es una garantía que no se puede ejecutar.
InmobiliarioContratos 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.
SegurosOnboarding regulado
Cuando el ente regulador pide prueba de lo que verificaste, el comprobante vale más que un log de API.
Cómo funciona
Entran dos datos. Sale la prueba.
Sin certificado digital, sin e-CNPJ (certificado digital de empresas en Brasil), sin procuración electrónica, sin fila en el sitio de la Receita Federal.
01
Envías dos datos
El CPF y la fecha de nacimiento del titular. Es lo que exige la Receita Federal para responder, así que es todo lo que pedimos.
02
Consultamos en el momento
Sin base intermedia ni copia de ayer. La consulta ocurre en la Receita Federal, en el momento en que llamas.
03
Vuelven el JSON y el comprobante
Situación de registro, año de fallecimiento (deathYear, entero o null), fecha y hora de emisión, código de control y el enlace al comprobante en HTML. Tu sistema decide y archiva la prueba.
La respuesta depende del tiempo de la Receita Federal. El tiempo típico es de cerca de 1 segundo, no es un SLA. Si tu flujo no puede esperar, la Consulta Simple cubre el camino crítico y esta cubre la prueba.
Intégrala en cualquier lenguaje
La misma clave que ya usas, una ruta distinta. Ejemplos listos en diez lenguajes.
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.fazenda.gov.br/Servicos/CPF/ca/ResultadoAut.asp?...",
"validationHtmlUrl": "https://api.cpfhub.io/cpf/proof/12345678909/1790950516000"
}
}FAQ
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, tiene un tiempo típico de ~150 ms (no es un SLA) 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, en cerca de 1 segundo (tiempo típico, no un SLA). 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 exitosa, frente a 1 crédito de la Consulta Simple (algunos planes tienen valores distintos). Sale del mismo saldo de tu plan, sin un paquete aparte. La Receita Federal fuera de línea (502), no disponible (503) o una fecha de nacimiento que no coincide (422) no debitan crédito.
¿Cuánto tarda?
La Consulta en Tiempo Real depende del tiempo de respuesta de la Receita Federal. El tiempo típico es de cerca de 1 segundo, no es un SLA. 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, escríbenos 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}.
¿Todavía tienes dudas?
ContáctanosSituación de registro
en tiempo real.
Situación de registro, año de fallecimiento, código de control y comprobante en HTML, directo desde la Receita Federal. 1,5 créditos por consulta, del mismo saldo de tu plan. 50 créditos gratis para probar.
Acceso inmediato a tu clave de API y a la documentación.