Plan Gratis
Una API de CPF gratis para probar de verdad
50 créditos/mes, sin tarjeta de crédito. El CPF es el número de identificación fiscal de personas físicas en Brasil. Ideal para un MVP y para la integración. Cuando superes el plan Gratis, el plan Pro empieza en R$19/mes (reales brasileños, BRL).
Qué devuelve la API
Nombre completo, género (M/F) y fecha de nacimiento. También nameUpper y día, mes y año por separado.
Sin throttling por segundo
No hay límite de solicitudes por segundo: el único control es el pool de créditos del mes. SLA de disponibilidad: 95% en el plan Gratis.
Sin créditos en el plan Gratis: 403
En el plan Gratis (sin excedente), GET /cpf con saldo cero devuelve 403 ("Limite de créditos excedido", el mensaje de la API en portugués, que significa límite de créditos excedido).
Docs + clave de API en minutos
Crea la cuenta, copia la clave en x-api-key y llama a GET /cpf/{cpf}. Documentación y ejemplos listos.
Ejemplo
Un GET y el JSON vuelve completo
Header x-api-key. Base https://api.cpfhub.io. Sin versión en la URL.
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
}
}FAQ
Preguntas frecuentes
¿Cuántas consultas incluye el plan Gratis?
El plan Gratis incluye 50 créditos por mes. Una Consulta Simple con CPF encontrado (HTTP 200) cuesta 1 crédito y una Consulta en Tiempo Real cuesta 1,5 créditos. Un CPF no encontrado (404) o con formato o dígito verificador incorrecto (400/422) no consume crédito. Los créditos no se acumulan para el mes siguiente.
¿Necesito tarjeta de crédito?
No. El plan Gratis no exige tarjeta. Creas la cuenta en app.cpfhub.io, generas la clave de API y empiezas a consultar.
¿Qué pasa cuando llego a 0 créditos?
En el plan Gratis (sin excedente), GET /cpf devuelve 403 con el mensaje "Limite de créditos excedido". En el lote, los ítems sin saldo se marcan como skipped. En los planes con excedente activo la consulta sigue funcionando y el excedente se cobra en el ciclo siguiente. Detalles en /es/precios.
¿El plan Gratis tiene SLA?
Sí. El SLA de disponibilidad depende del plan: Gratis 95%, Pro 99%, Enterprise 99,9%. Consulta /es/precios. El tiempo típico de la Consulta Simple es ~150 ms y el de la Consulta en Tiempo Real es de cerca de 1 segundo. Son referencias típicas, no un SLA. En la Consulta por Lote, el tiempo depende de cuántos CPF vienen en el envío, y cada consulta queda en el mismo rango que la Consulta Simple.
¿Todavía tienes dudas?
ContáctanosEmpieza hoy
en el plan Gratis.
50 créditos/mes, sin tarjeta. Clave de API en el dashboard. Cuando crezcas, el plan Pro empieza en R$19/mes.
Acceso inmediato a tu clave de API y a la documentación.