Free plan
A free CPF API you can really test with
50 credits/month, no credit card. A CPF is Brazil's individual taxpayer ID. Ideal for an MVP and for integration. When you outgrow Free, Pro starts at R$19/month (Brazilian reais, BRL).
What the API returns
Full name, gender (M/F) and date of birth. Also nameUpper and day, month and year as separate fields.
No per-second throttling
Default limit of 30 requests per minute on Simple Lookup (each batch counts as 1) and 5 on Real-Time Lookup, adjustable on custom plans. Usage is controlled by the monthly credit pool. Availability SLA: 95% on the Free plan.
No credits on Free: 403
On the Free plan (no overage), GET /cpf with a zero balance returns 403 ("Limite de créditos excedido", the API's message in Portuguese, meaning credit limit exceeded).
Docs + API key in minutes
Create the account, copy the key into x-api-key and call GET /cpf/{cpf}. Documentation and examples ready to use.
Example
One GET and the full JSON comes back
x-api-key header. Base https://api.cpfhub.io. No version in the 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
Frequently asked questions
How many lookups does the Free plan include?
The Free plan includes 50 credits a month. A Simple Lookup that finds the CPF (HTTP 200) costs 1 credit and a Real-Time Lookup costs 1.5 credits. A CPF that is not found (404) or has an incorrect format or check digit (400/422) does not use a credit. Credits do not roll over to the next month.
Do I need a credit card?
No. The Free plan does not require a card. You create the account at app.cpfhub.io, generate the API key and start looking up CPFs.
What happens at 0 credits?
On the Free plan (no overage), GET /cpf returns 403 with the message "Limite de créditos excedido". In batch, items with no balance are marked as skipped. On plans with overage enabled the lookup keeps going and the overage is billed in the next cycle. Details at /en/pricing.
Does the Free plan have an SLA?
Yes. The availability SLA depends on the plan: Free 95%, Pro 99%, Enterprise 99.9%. See /en/pricing. In the Batch Lookup, time depends on how many CPFs are in the submission.
Still have questions?
Get in touchStart on Free
today.
50 credits/month, no card. API key in the dashboard. When you grow, Pro starts at R$19/month.
Instant access to your API key and documentation.