API de consulta de CPF com dados oficiais
Envie o CPF e a data de nascimento e receba nome, situação cadastral e data de inscrição em um JSON padronizado. Quem não confere com a base oficial volta como não encontrado, sem gastar crédito.
Plano gratuito com 20 consultas por mês. Sem cartão de crédito.
Resultado da consulta
- CPF
- 529.982.247-25
- Nome
- MARIA SOUZA LIMA
- Nascimento
- 26/11/1982
- Situação
- REGULAR
O que a consulta devolve
Os dados cadastrais do CPF, prontos para confirmar quem é o seu cliente.
- Nome e nome social
- Nome completo do titular e, quando existir, o nome social cadastrado.
- Situação cadastral
- Regular, suspensa, pendente de regularização, cancelada de ofício ou nula, como a Receita Federal publica.
- Data de nascimento
- Devolvida em texto e também separada em dia, mês e ano, para você validar maioridade sem conversão.
- Data de inscrição
- Quando o CPF foi inscrito na Receita Federal, útil para identificar cadastros muito recentes.
- CPF e nascimento conferidos juntos
- A consulta só retorna dados quando o CPF e a data de nascimento batem, o que reduz o uso de CPFs de terceiros.
- Resposta padronizada
- Mesmo envelope em todas as consultas, com o saldo de créditos restantes, se você quiser exibi-lo.
Como funciona
- 1
Validação local
Antes de qualquer busca, conferimos o formato e os dígitos verificadores. CPF inválido volta com erro 422 e não gasta crédito.
- 2
Resposta rápida
CPFs consultados recentemente respondem em milissegundos, com o mesmo preço de uma consulta nova.
- 3
Fonte oficial
Quando necessário, consultamos a base oficial e devolvemos o resultado já padronizado.
Uma chamada, um JSON
Autentique com o cabeçalho x-api-key e envie o CPF e a data de nascimento.
Documentação do endpointcURL POST /v1/cpf
Resposta
Consulta concluída com sucesso.
CPF não encontrado na base oficial.
Quanto custa
1 crédito por consulta com sucesso
Só a resposta 200 consome crédito. CPF inválido, não encontrado, erro de autenticação e indisponibilidade não cobram nada.
Sandbox sem custo
Chaves de sandbox (brz_test_) respondem com dados de teste e nunca debitam saldo. Use para integrar sem gastar créditos.
Excedente sem interrupção
Nos planos pagos a API segue respondendo depois da franquia, com o preço do excedente do seu plano. No plano gratuito ela para ao esgotar.
Onde usar
Cadastro e onboarding
Confirme nome e situação do CPF antes de abrir a conta e recuse cadastros com dados que não batem.
Verificação de maioridade
Use a data de nascimento oficial para liberar produtos e serviços restritos a maiores de 18 anos.
Antifraude e crédito
Cruze o CPF informado com a base oficial antes de aprovar uma compra ou uma análise de crédito.
Perguntas frequentes
Preciso enviar a data de nascimento?
Sim. A consulta exige o CPF e a data de nascimento (AAAA-MM-DD). Se os dois não conferirem com a base oficial, a resposta é 404 e nada é cobrado.
De onde vêm os dados?
Da base oficial do CPF na Receita Federal, consultada por um provedor autorizado. A BrazID padroniza a resposta e mantém um histórico de consultas recentes para responder mais rápido.
O que acontece com CPF inválido?
Se o formato estiver errado a API responde 400; se os dígitos verificadores não baterem, 422. Nos dois casos nenhuma base é consultada e nenhum crédito é gasto. Para só conferir o número, use o validador gratuito.
Posso testar sem gastar créditos?
Pode. O sandbox (api-sandbox.brazid.com) responde com CPFs de teste em vários cenários e não debita saldo. Há também uma coleção do Insomnia pronta para importar.
Quantas consultas por segundo?
Depende do plano: 5 req/s no gratuito, 20, 50 e 100 nos pagos. Passou do limite, a API responde 429 com o cabeçalho Retry-After.
Outros produtos da BrazID
Todos usam a mesma chave de API e o mesmo saldo de créditos.
Valide CPFs com dados oficiais
Crie sua conta, gere uma chave de sandbox e faça a primeira consulta de CPF em minutos.
Plano gratuito com 20 consultas por mês. Sem cartão de crédito.