Gratuito
R$ 0/mês
20 consultas incluídas por mês, renovadas a cada ciclo
- Consulta excedente
- Bloqueado (erro 402)
- Limite de taxa
- 5 req/s
- Acesso completo
- API REST
- Histórico de consultas
- Suporte por WhatsApp e e-mail
API de Consulta de CPF
Consulte e valide CPFs com dados oficiais e alta precisão
API de consulta de CPF e dados cadastrais diretamente na Receita Federal para fintechs, e-commerces e SaaS. Proteja seu negócio contra cadastros falsos com uma integração simples, escalável e de baixo custo.
Plano gratuito, sem cartão de crédito.
- Verificação de idade
- Verificação de identidade
- Situação cadastral
O caminho de cada consulta
A maioria das consultas é respondida pela nossa própria base. A fonte oficial só é acionada quando o dado não existe ou tem mais de 30 dias.
- 1
Validação local
Formato e dígitos verificadores conferidos na borda, sem tocar em banco de dados.
- 2
Cache em memória
Dados consultados nos últimos 30 dias voltam do Redis em milissegundos.
- 3
Base própria
Se não estiver em memória, buscamos no nosso PostgreSQL e reaquecemos o cache.
- 4
Fonte oficial
Só então consultamos o provedor. Se ele estiver instável, respondemos 503 sem cobrar.
Seja qual for a origem do dado, uma consulta encontrada custa exatamente 1 crédito.
Preços claros.Sem surpresas no fim do mês.
Pro
R$ 149/mês
Créditos por mês
- Custo por consulta
- R$ 0,149
- Consulta excedente
- R$ 0,15
- Limite de taxa
- 50 req/s
- Acesso completo
- API REST
- Histórico de consultas
- Suporte por WhatsApp e e-mail
Corporativo
Sob consulta
A partir de 10.000 consultas incluídas
- Consulta excedente
- Em contrato
- Limite de taxa
- 200+ req/s
- Acesso completo
- API REST
- Histórico de consultas
- Suporte por WhatsApp e e-mail
- Só respostas 200 consomem crédito. Erros de validação, autenticação, limite e indisponibilidade são gratuitos.
- A franquia vale por 30 dias e não acumula para o ciclo seguinte, inclusive no plano gratuito (20 consultas por ciclo).
- Avisos por e-mail e webhook quando o consumo chega a 80% e 95% da cota.
Integre em qualquer linguagem
Uma requisição HTTP e uma chave de API. Veja como consultar um CPF na sua linguagem e o que a API responde.
cURL GET /v1/cpf/52998224725
1curl -X GET \2 'https://api.brazid.com/v1/cpf/52998224725' \3 -H 'x-api-key: YOUR_API_KEY'
1const res = await fetch(2 'https://api.brazid.com/v1/cpf/52998224725',3 {4 headers: { 'x-api-key': 'YOUR_API_KEY' },5 },6);7 8const { data } = await res.json();9console.log(data.name);
1import requests2 3res = requests.get(4 'https://api.brazid.com/v1/cpf/52998224725',5 headers={'x-api-key': 'YOUR_API_KEY'},6)7 8print(res.json()['data']['name'])
1<?php2$ch = curl_init('https://api.brazid.com/v1/cpf/52998224725');3curl_setopt_array($ch, [4 CURLOPT_RETURNTRANSFER => true,5 CURLOPT_HTTPHEADER => ['x-api-key: YOUR_API_KEY'],6]);7 8$data = json_decode(curl_exec($ch), true);9echo $data['data']['name'];
1var request = HttpRequest.newBuilder()2 .uri(URI.create("https://api.brazid.com/v1/cpf/52998224725"))3 .header("x-api-key", "YOUR_API_KEY")4 .GET()5 .build();6 7var response = HttpClient.newHttpClient()8 .send(request, HttpResponse.BodyHandlers.ofString());9 10System.out.println(response.body());
1req, _ := http.NewRequest("GET", "https://api.brazid.com/v1/cpf/52998224725", nil)2req.Header.Set("x-api-key", "YOUR_API_KEY")3 4res, _ := http.DefaultClient.Do(req)5defer res.Body.Close()6 7body, _ := io.ReadAll(res.Body)8fmt.Println(string(body))
1require 'net/http'2require 'json'3 4uri = URI('https://api.brazid.com/v1/cpf/52998224725')5res = Net::HTTP.get(uri, { 'x-api-key' => 'YOUR_API_KEY' })6 7puts JSON.parse(res)['data']['name']
1using var client = new HttpClient();2client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");3 4var body = await client.GetStringAsync("https://api.brazid.com/v1/cpf/52998224725");5Console.WriteLine(body);
Resposta
1{2 "success": true,3 "data": {4 "cpf": "52998224725",5 "name": "MARIA SOUZA LIMA",6 "birthdate": "26/11/1982",7 "day": 26,8 "month": 11,9 "year": 1982,10 "gender": "M",11 "deceased": false12 }13}
1{2 "error": "CPF not found"3}
Consulta concluída com sucesso.
CPF não encontrado na base oficial.
Perguntas frequentes
De onde vêm os dados?
Da base oficial de CPF por meio de um provedor credenciado. Guardamos o resultado por até 30 dias para responder mais rápido as consultas repetidas.
O que conta como uma consulta cobrada?
Apenas respostas com status 200, ou seja, CPF encontrado. CPF com formato inválido (400), dígito verificador errado (422), não encontrado (404), limite de taxa (429) ou indisponibilidade (503) não consomem crédito.
O que acontece quando minha cota acaba?
No plano gratuito a API responde 402 (Payment Required) quando as 20 consultas do ciclo acabam, até a renovação. Nos planos Pro e Corporativo ela continua respondendo e cada consulta excedente é cobrada no fim do ciclo, pelo valor do seu plano.
Como vocês tratam dados pessoais?
Toda comunicação usa TLS, as chaves de API são guardadas apenas como hash SHA-256 e os CPFs aparecem mascarados (123.***.***-00) em todos os logs e relatórios.
Posso cancelar quando quiser?
Sim. Ao cancelar, sua conta volta ao plano gratuito no fim do ciclo pago.
Faça sua primeira consulta em poucos minutos.
Crie a conta, confirme o e-mail e gere sua chave de API no painel.