Consulta Simple
API de consulta de CPF.
Nombre y nacimiento al instante.
Envía solo el CPF (el número de identificación fiscal de personas físicas en Brasil) y recibe nombre, género y fecha de nacimiento en JSON. Tiempo típico ~150 ms. Sin e-CNPJ (identificación de empresas en Brasil), sin certificado digital, sin reunión comercial. 50 créditos gratis al mes para probar.
Sin tarjeta de crédito. La clave aparece en el dashboard al instante.
Lo que recibes
Entra el CPF. Sale la persona.
Once dígitos se convierten en un registro completo, antes de que la persona termine de escribir.
El nombre del titular
Nombre completo, con acentos y mayúsculas ya normalizados. Entra en tu base de datos listo, sin tratamiento intermedio.
La fecha de nacimiento
Con formato y también separada en día, mes y año. Aplicar una regla de mayoría de edad pasa a ser una comparación de números, no un parseo de texto.
El género
M o F, según el registro. Suficiente para personalizar la comunicación y reforzar una regla de coincidencia en el registro.
Todo eso en ~150 ms
Lo bastante rápido para quedar dentro del formulario, del checkout y del login, sin que el usuario note que hubo una consulta.
Dónde usarlo
Hecha para el camino crítico.
Responde lo bastante rápido para quedar dentro del registro, el checkout y el login, sin que el usuario lo note.
Completar el formulario de registro
La persona escribe el CPF y el resto del formulario se completa solo. Menos campos que llenar significa menos abandono, y los datos entran en tu base ya estandarizados.
Prevención de fraude en el registro y el checkout
Compara el nombre y la fecha que informó la persona con lo que devuelve la API. Una divergencia pasa a revisión manual en vez de un contracargo.
Verificación de edad
El campo year viene separado justamente para esto. Calcula la edad sin parsear texto y aplica tu regla de rango de edad.
Limpieza y enriquecimiento de base
Una base antigua con nombres mal escritos o sin fecha de nacimiento. Pasa los CPF por la API y normaliza todo el registro.
Verificación en atención al cliente
El agente confirma el nombre y la fecha de nacimiento del titular durante la llamada, sin depender de lo que el cliente recuerde en el momento.
Agentes de IA vía MCP
El servidor MCP oficial expone la consulta como tool. Claude, Cursor y Windsurf consultan un CPF sin que escribas un cliente HTTP.
Créditos y errores
Un CPF no encontrado no consume créditos.
Pagas por resultado, no por intento. Una base desordenada no se convierte en una factura inflada.
Cómo se consume el crédito
- Una consulta que encuentra el CPF consume 1 crédito.
- Un CPF válido sin registro devuelve 404 y no consume nada.
- Un CPF con dígito verificador incorrecto ni siquiera llega a consultarse.
- GET /quota muestra el saldo y nunca consume crédito.
- No existe un límite de solicitudes por segundo. El control es el pool mensual de créditos.
Códigos de respuesta
| 200 | CPF encontrado. Consume 1 crédito. |
| 400 | El CPF no tiene 11 dígitos después de quitar los caracteres no numéricos. |
| 401 | Clave de API ausente o inválida. |
| 403 | Créditos del mes agotados, en un plan sin excedente. |
| 404 | CPF válido, pero sin registro. No consume crédito. |
| 422 | Dígito verificador incorrecto, incluidas las secuencias repetidas. |
Cómo funciona
Tres pasos, ninguno burocrático.
Desde la cuenta creada hasta el primer JSON en producción, sin intermediario comercial de por medio.
01
Crea la cuenta y copia la clave
Registro self-serve en app.cpfhub.io. Sin e-CNPJ (identificación de empresas en Brasil), sin certificado digital, sin contrato firmado. La clave de API aparece en el dashboard en la misma pantalla.
02
Llama a GET /cpf/{cpf}
Una solicitud HTTP con el header x-api-key. El CPF va en la URL, con o sin formato. No hay cuerpo, no hay OAuth, no hay token que expire.
03
Recibe el JSON y sigue
Nombre, género y fecha de nacimiento vuelven en ~150 ms (tiempo típico), ya normalizados. Tu formulario se completa solo o tu regla de coincidencia decide al instante.
Respuesta
Lo que devuelve la API
Ocho campos, siempre los mismos, siempre con el mismo formato. Sin campos que aparecen a veces.
| Campo | Tipo | Descripción |
|---|---|---|
| cpf | string | CPF de 11 dígitos, sin formato, siempre con el mismo formato. |
| name | string | Nombre completo del titular, con acentos y mayúsculas normalizados. |
| nameUpper | string | El mismo nombre en mayúsculas, listo para comparar sin normalizar de nuevo. |
| gender | string | M o F. |
| birthDate | string | Fecha de nacimiento en DD/MM/AAAA. |
| day | number | Día de nacimiento, ya separado. |
| month | number | Mes de nacimiento, ya separado. |
| year | number | Año de nacimiento, ya separado. Útil para calcular la edad sin parsear texto. |
Esta ruta no devuelve situación de registro, año de fallecimiento, score, dirección, teléfono ni correo electrónico. Si necesitas la situación de registro, el año de fallecimiento y el comprobante, el camino es la Consulta en Tiempo Real.
Planes
Empieza en el plan Gratis. Sube cuando lo necesites.
El mismo saldo vale para la Consulta Simple (1 crédito) y la Consulta en Tiempo Real (1,5 créditos). Cambias de ruta sin cambiar de plan. Todos los precios están en reales brasileños (BRL).
Gratis
R$ 0
50 créditos al mes, sin tarjeta
SLA 95%
Pro
Desde R$ 19
100 a 10.000 créditos/mes, excedente de R$ 0,19 a R$ 0,10
SLA 99%
Enterprise
A consultar
Más de 10.000 créditos al mes
SLA 99,9%
En producción
Ya funciona en el registro de quienes escalan.
6.000+
empresas atendidas
30 millones+
de CPF verificados
50
consultas gratis al mes, sin tarjeta
Intégrala en cualquier lenguaje
API REST con especificación OpenAPI y ejemplos listos, tan simple que tu agente de IA puede integrarla por sí solo.
curl -X GET \
'https://api.cpfhub.io/cpf/12345678909' \
-H 'x-api-key: YOUR_API_KEY'{
"success": true,
"data": {
"cpf": "12345678909",
"name": "Fulano de Tal",
"nameUpper": "FULANO DE TAL",
"gender": "M",
"birthDate": "15/06/1990",
"day": 15,
"month": 6,
"year": 1990
}
}50 créditos gratis al mes, sin tarjeta.
FAQ
Preguntas frecuentes
¿Qué devuelve la API de consulta de CPF?
Nombre completo, género (M/F) y fecha de nacimiento. Campos: cpf (11 dígitos sin formato), name, nameUpper, gender, birthDate, day, month y year. No devuelve score, dirección, teléfono ni correo. Para situación de registro, año de fallecimiento y comprobante, usa la Consulta en Tiempo Real en /es/consulta-cpf-receita-federal.
¿Hay GET individual y lote?
Sí. La Consulta Simple es GET /cpf/{cpf} y el lote es POST /cpf/bulk (hasta 10.000 CPF, job asíncrono con polling en GET /cpf/bulk/{jobId}). También existe GET /quota para saldo y plan, sin consumir crédito.
¿Necesito e-CNPJ o certificado digital?
No. La integración es self-serve: crea la cuenta, copia la clave de API y envíala en el header x-api-key. Sin e-CNPJ y sin biometría.
¿Cuánto cuesta la API de consulta de CPF?
Gratis: 50 créditos/mes, sin tarjeta, SLA de 95%. Pro: desde R$19/mes con 100 créditos (hasta 10.000), excedente de R$0,19 a R$0,10 por crédito según el volumen, SLA de 99%. Enterprise: a consultar, SLA de 99,9%. Consulta /es/precios.
¿Cuál es la diferencia con la Consulta en Tiempo Real?
La Consulta Simple necesita solo el CPF y tiene un tiempo típico de ~150 ms (no es un SLA) desde nuestra base, con nombre, género y fecha de nacimiento, por 1 crédito. La Consulta en Tiempo Real necesita además la fecha de nacimiento del titular, consulta en tiempo real la Receita Federal (la autoridad tributaria federal de Brasil) 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), por 1,5 créditos por consulta exitosa. Las dos usan la misma clave y el mismo saldo.
¿Existe un límite de solicitudes por segundo?
No. No hay throttling por segundo ni header de rate limit. El único límite es el saldo de créditos del plan. En el plan Gratis (50 créditos/mes), la API se detiene cuando se agotan los créditos. Los planes de pago con excedente activo siguen respondiendo y el excedente se cobra en el ciclo siguiente.
¿Un CPF no encontrado consume crédito?
No. Solo la consulta que devuelve datos debita crédito. Un CPF válido sin registro devuelve 404 sin cobro, y un CPF con dígito verificador errado devuelve 422 sin siquiera consultarse.
¿Se puede usar con agentes de IA?
Sí. El servidor MCP oficial está en https://api.cpfhub.io/mcp y expone la consulta como tool para Claude, Cursor y Windsurf, con la misma x-api-key. No hace falta escribir un cliente HTTP.
¿La API cumple con la LGPD?
Sí. Tratamos los datos personales con base legal y prácticas de privacidad. La LGPD es la ley brasileña de protección de datos. DPO: dpo@cpfhub.io. Política en /es/privacidad.
¿Todavía tienes dudas?
ContáctanosIntegra la API de CPF
en minutos.
50 créditos gratis al mes. Sin e-CNPJ, sin certificado digital, sin tarjeta.
Acceso inmediato a tu clave de API y a la documentación.