NuevoVerificación de identidad facial

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.

situation

El 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.

deathYear

El 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.

validationHtmlUrlvalidationUrl

Emisió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.

emissionDateemissionTimecontrolCode

La 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 respuesta

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.

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.

  1. 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.

  2. 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.

  3. 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.

cURLPOST /cpf/realtime
# 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"}'
Respuesta
200 OK
{
  "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

Atención automatizada las 24 horas

¿Aún tienes dudas?

Escríbenos por WhatsApp.

Hablar con el equipo
¿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
WhatsApp