CPF lookup API for signup, checkout and anti-fraud
The lookup checks name, date of birth and mother’s name before a signup or a payment is approved. The free plan includes 10 lookups a month; paid plans include 10,000 and overage is BRL 0.01 via PIX.
Company token
Each account has its own token. The call uses HTTPS.
Lookup at signup
The response is JSON, so signup and checkout can check the CPF immediately.
Five fields
233+ million CPFs. The payload includes name, sex, date of birth and mother name.
Dashboard and PIX
The monthly plan is BRL 97. Usage and the token live in the dashboard.
Email support
Paid plans reach support by email, in Portuguese.
Allowance + overage
10,000 lookups on paid plans. After that, BRL 0.01 per lookup via PIX.
API CPF Nacional v2.0
Ultra-fast integration with the largest CPF database in Brazil
curl -X GET "https://api.cpf-brasil.org/cpf/12345678901" \
-H "X-API-Key: SEU_TOKEN_AQUI" \
-H "Content-Type: application/json"const response = await fetch('https://api.cpf-brasil.org/cpf/12345678901', {
method: 'GET',
headers: {
'X-API-Key': 'SEU_TOKEN_AQUI',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);import requests
url = "https://api.cpf-brasil.org/cpf/12345678901"
headers = {
"X-API-Key": "SEU_TOKEN_AQUI",
"Content-Type": "application/json"
}
response = requests.get(url, headers=headers)
data = response.json()
print(data)<?php
$url = "https://api.cpf-brasil.org/cpf/12345678901";
$headers = [
"X-API-Key: SEU_TOKEN_AQUI",
"Content-Type: application/json"
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$data = json_decode($response, true);
print_r($data);Advanced API Features
Transparent Overage
10,000 included + R$ 0.01 per extra lookup via PIX
CORS Enabled
Works directly in the browser
Structured Logs
Real-time monitoring
Friendly URLs
RESTful API design
Secure HTTPS
SSL/TLS encrypted
Consulta em JSON
High availability
How to get your API token
Replace "SEU_TOKEN_AQUI" in the examples with your personal token
Sign Up for Free
Go to dash.cpf-brasil.org and create your account
Open the Dashboard
Log in and access your control panel
Copy your Token
Your unique token will be available in the dashboard
API Playground
Test our API in real time with real data
Where the CPF lookup fits
Moments in the commercial flow. No invented fraud rate.
A consulta roda antes de aprovar o pedido.
Nome e nascimento são conferidos no alta do cliente.
O CPF informado é cruzado com o nome digitado.
O excedente de R$ 0,01 sai no PIX do painel.
O plano mensal custa R$ 97, com 10.000 consultas inclusas.
O CPF de quem vai vender é conferido antes da conta.
Um token da empresa serve o balcão e o sistema.
O painel mostra o consumo da franquia.
O pagamento do plano gera nota no fluxo da Hotmart.
Plano pago fala com o suporte por e-mail.
A resposta traz nome, sexo, nascimento e nome da mãe.
O plano gratuito inclui 10 consultas por mês.
What the CPF lookup returns
Fields, allowance and billing. No commercial-result claim.
Capabilities
How to validate a CPF in your signup flow
Integrate in under 5 minutes and start validating CPFs with official data
Create Your Free Account
Sign up in under a minute. No credit card. 10 free lookups to test.
Generate Your Token
In the dashboard, generate your unique token with one click. Secure and easy to use.
Make Your First Request
Call the /cpf/{number} endpoint with your token. Instant JSON response.
Integrate Into Your System
Works in any language: PHP, Python, Node.js, Java, C#. Full examples in the documentation.
Where a CPF check fits checkout and onboarding
The lookup runs before a signup, a payment or a seller account is approved.
Checkout
Checks the order CPF before the payment continues.
Signup
Checks name and date of birth during onboarding.
Anti-fraud
Compares the CPF with the name the customer typed.
Plan
Monthly at BRL 97, plus quarterly and yearly in the dashboard. Overage via PIX.
Marketplace
Checks the seller CPF before the account is opened.
Operations
The same company token serves the counter and the system.
Choose Your Plan
Unlock the full potential of API CPF Nacional
Monthly
- 10,000 lookups/month included
- Overage at R$ 0.01/lookup via PIX
- No rate limiting
- Priority support
- Advanced dashboard
- Detailed reports
- HTTPS lookup
Quarterly
- 10,000 lookups/month included
- Overage at R$ 0.01/lookup via PIX
- No rate limiting
- Priority support
- Advanced dashboard
- Detailed reports
- HTTPS lookup
- Guaranteed Savings
Annual
- 10,000 lookups/month included
- Overage at R$ 0.01/lookup via PIX
- No rate limiting
- Priority support
- Advanced dashboard
- Detailed reports
- HTTPS lookup
- Guaranteed Savings
- Biggest Discount
Plan payment via PIX, card, bank slip and PayPal through Hotmart
Overage: R$ 0.01 per lookup, billed separately via PIX in the dashboard
Questions about CPF lookup and validation
Everything you need to know about our CPF lookup and validation API
Data and Quality
API CPF Nacional looks up a cadastral dataset of 233+ million CPFs of official origin. It is not the SERPRO API and not the Receita Federal online check. Each response includes name, sex, date of birth and mother’s name.
JSON with CPF, NOME, SEXO, NASC and NOME_MAE. It does not return live tax status, a credit score, address, phone or email.
The lookup returns JSON for your system to decide. This page does not publish a millisecond average.
Plans and Payment
Simple and professional: 1) create your account in the Dashboard, 2) choose your plan inside the platform, 3) pay by PIX straight from the dashboard (QR code + exact amount), 4) receive your token and start using it right away.
PIX fully organised through the dashboard. You get the charge inside the platform with a QR code, the exact amount and a clear due date. No chasing by message, no guessing the amount, no confusion. Once paid, access is released automatically along with the tax invoice.
Of course. Cancel automatically from the dashboard whenever you want. No red tape, no retention calls. Your company, your rules.
Yes, automatically. An electronic invoice is issued on the payment date and sent by email — ready for your finance team, not a bare PIX transfer receipt.
Technical / Integration
Very simple. We provide ready-made examples in PHP, JavaScript, Python and cURL, plus complete documentation with real use cases. Integration takes under 10 minutes.
Transparent, fair limits: the free plan includes 10 lookups/month for testing. Paid plans include 10,000 lookups/month and overage costs R$ 0.01 per lookup via PIX. Everything stated clearly — no surprises.
Yes. An interactive playground right here on the site, plus the official test CPF (000.000.001-91) for your development environments.
The service answers over HTTPS. This page does not publish an uptime percentage.
Support
Professional email support with a reply within 4 business hours, handled by a specialised technical team — not one developer answering from a phone at midnight.
Complete, up-to-date documentation. Endpoints, parameters, error codes and practical examples. Everything you need, without having to ask over chat.
Our team helps you. Integration support is included on every plan. We review your code, suggest improvements and make sure it works properly.
Start Using API CPF Nacional Now
Create your account and start using our API immediately.
Full dashboard • 10,000 lookups included • Overage via PIX