BitBusca › Desenvolvedores › API de CPF

Consulta de CPF por API: cadastro preenchido, fraude barrada

Mande o CPF, receba o cadastro em JSON: nome completo, nascimento, nome da mãe e situação cadastral. Para preencher cadastro, conferir quem está do outro lado e reduzir fraude no onboarding.

Hoje: Cliente digitando o nome errado, conta aberta com o CPF de outra pessoa, analista conferindo cadastro à mão. Com a API: O CPF entra; nome, nascimento, mãe e situação voltam em JSON, e o seu sistema decide sozinho se libera.

1 crédito por CPF · escopo consultas:pessoa · planos a partir de R$ 19,90/mês. Chave de teste grátis.

O que cada CPF traz

O retorno depende do que está registrado para aquele CPF: nem todo cadastro tem nome do pai, telefone ou endereço recente. Algumas consultas de pessoa estão temporariamente fora do catálogo e outras entram em breve — GET /v1/consultas mostra o que está no ar agora.

Consultar um CPF

curl https://api.bitbusca.net/api/v1/cpf/00000000191 \
  -H "Authorization: Bearer $BITBUSCA_API_KEY"

{
  "tipo": "CPF",
  "consulta": "000.000.001-91",
  "custo": 1,
  "dados": {
    "nome": "MARIA EXEMPLO DE SOUZA",
    "nascimento": "1988-03-14",
    "sexo": "F",
    "mae": "JOANA EXEMPLO DE SOUZA",
    "situacao": "REGULAR"
  }
}

Exemplo fictício, formato resumido. Referência completa: OpenAPI.

Por que integrar

• Cadastro em segundos — O cliente digita o CPF e o formulário se preenche. Menos campos, menos abandono.
• Fraude barrada na entrada — Nome e nascimento que não batem com o CPF param antes de virar conta, crédito ou pedido.
• Situação cadastral na hora — Saiba se o CPF está regular antes de seguir com o contrato.
• Paga só o que encontra — 1 crédito por CPF. Nada encontrado (404) ou erro do nosso lado não cobra: o débito volta na hora.

Para quem é

• Fintech e onboarding — Conta aberta com CPF de terceiro vira fraude, estorno e conversa difícil com o compliance. Confira nome, nascimento e situação antes de liberar a conta, no mesmo fluxo do cadastro.
• Cobrança e recuperação de crédito — Negociar com a pessoa errada queima a ligação e expõe a empresa. Confirme quem é o devedor antes de ligar ou mandar a proposta de acordo.
• RH e admissão — Ficha de admissão com dado digitado errado volta e atrasa a folha. Nome, nascimento e nome da mãe preenchidos a partir do CPF do contratado.
• E-commerce e marketplace — Pedido caro feito com os dados de outra pessoa. Compare o comprador com o CPF antes de despachar.

O que você recebe

• nome — O nome como está no cadastro: preenche o formulário e confere com o que a pessoa digitou.
• nascimento — Confirma a identidade e a maioridade, para contrato, crédito ou venda restrita.
• mae — O dado que separa homônimos e serve de pergunta de segurança no atendimento.
• situacao — Regular ou não: decide se o cadastro segue direto ou vai para análise.
• sexo — Completa a ficha sem precisar perguntar.
• custo — Quantos créditos a chamada gastou, para o seu controle de uso.

Dado de pessoa, com as regras que o seu compliance vai pedir

Os tetos e o registro de cada chamada não estão aqui para atrapalhar: são o que o jurídico e o compliance (seu ou do seu cliente) querem ver antes de aprovar a integração.

• Cadastro e onboarding de cliente
• Prevenção a fraude e conferência de identidade
• Proteção ao crédito e cobrança
• Admissão e cumprimento de contrato
• Conta identificada, com CPF e WhatsApp confirmados, por trás de cada chave
• Detector de varredura: documentos ou números em sequência pausam a chave por 1 hora
• Cada chamada registrada no log da sua conta, sem gravar o dado consultado
• Termos proíbem revenda, redistribuição e base derivada

O que entrega

• Nome completo
• Data de nascimento e sexo
• Nome da mãe (e do pai, quando registrado)
• Situação cadastral
• Outras consultas de pessoa do catálogo (endereços, parentes…) quando estiverem no ar — a lista viva sai em GET /v1/consultas

Endpoints e custo

• GET /v1/cpf/{cpf} — Cadastro da pessoa pelo CPF (só números) (1 crédito)
• GET /v1/consultas — Catálogo de consultas no ar, com rota, custo e escopo (grátis)
• GET /v1/me — Plano, saldo de créditos e uso do dia (grátis)

Limites e proteção

• 1 crédito por consulta, debitado do pool mensal do plano; 404 não cobra.
• Detector de varredura: CPFs em sequência ou volume fora do padrão pausam a chave por 1 hora (429 ENUMERACAO).
• Cada chamada fica no log da conta (sem gravar o CPF consultado no log de chamadas).
• Uso com finalidade legítima, conforme a LGPD — a responsabilidade pelo uso é de quem consulta.

Casos de uso

• Cadastro sem digitação — O cliente digita o CPF e o formulário se preenche sozinho.
• Onboarding de fintech — Confira nome e nascimento antes de liberar a conta.
• E-commerce — Compare o comprador com o CPF antes de despachar um pedido caro.
• Cobrança — Confirme a pessoa antes de negociar.

Prompt para Lovable, Cursor ou Bolt

Crie um formulário de cadastro em que, ao digitar um CPF válido, o nome completo e a data de nascimento sejam preenchidos automaticamente com GET /v1/cpf/{cpf} (só números). Valide os dígitos do CPF antes de chamar a API.

Use a API da BitBusca (base https://api.bitbusca.net/api). A especificação OpenAPI está em https://api.bitbusca.net/api/v1/openapi.json.
Autentique com o cabeçalho "Authorization: Bearer <chave>", lendo a chave da variável de ambiente BITBUSCA_API_KEY.
Nunca coloque a chave no código do navegador: faça as chamadas por uma função de servidor (edge function, API route ou backend).
Trate os erros pelo campo "code" da resposta: 402 NO_CREDITS (sem créditos), 429 RATE (respeite o cabeçalho Retry-After), 429 COTA_DIARIA (teto do dia atingido), 404 NOT_FOUND (mostre "nada encontrado", não é cobrado).
Comece com a chave de teste (bk_test_…), que devolve dados fictícios e não gasta créditos.

Perguntas frequentes

Dá para testar sem pagar?

Sim. A chave de teste (bk_test_…) é grátis, não expira com o sandbox e devolve dados fictícios no mesmo formato da produção — dá para montar a tela inteira sem gastar nada. Quando quiser dado real, ative o sandbox: 7 dias com 50 créditos reais, 10 requisições por minuto, 2 chaves e 1 webhook, uma vez por conta.

Pago por chamada que não encontra nada?

Não. Resposta 404 (nada encontrado) e erro do nosso lado (5xx) não gastam créditos: o débito é estornado na hora.

Preciso mandar o CPF formatado?

Não. Mande só os 11 números; a resposta devolve o CPF formatado no campo "consulta".

Posso guardar o resultado no meu banco?

Pode guardar o que o seu sistema precisa para a finalidade declarada (o cadastro do seu cliente, por exemplo). O que não pode é montar uma base derivada para revender ou redistribuir — isso está nos termos da API e suspende a chave.

Consultar CPF por API é permitido pela LGPD?

É, quando há base legal para a finalidade: execução de contrato, proteção ao crédito, prevenção a fraude ou cumprimento de obrigação legal, entre outras (art. 7º da LGPD). A API registra cada chamada por chave e os termos proíbem revenda; a responsabilidade pela finalidade é de quem consulta.

Tem limite de consultas por dia?

O limite é o pool mensal de créditos do plano (1 crédito por CPF) e as requisições por minuto de cada plano. Você ainda pode pôr um teto diário de créditos em cada chave. O que pausa a chave é varredura: documentos em sequência ou volume fora do padrão.

Outras APIs

• API de telefone — Titular e endereço a partir do número com DDD. (1 crédito por número)
• API de busca por nome — Pessoas encontradas pelo nome, com dados para separar homônimos. (1 crédito por busca)
• API de placa — Dados do veículo pela placa ou pelo número do motor. (5 créditos por placa)
• API de CNPJ — Ficha da empresa com quadro de sócios, pelo CNPJ. (1 crédito por CNPJ)
• API de empresas (leads B2B) — Empresas por CNAE, cidade, porte e abertura — leads B2B. (1 crédito por página)
• API de leads de pessoas — Contatos por região, sem CPF e sem repetição, a partir do Scale. (1 crédito a cada 10 contatos, a partir do Scale)
• API de advogados (OAB) — Ficha do advogado pela OAB e busca por nome. (1 crédito por ficha)
• API do DJEN (publicações e prazos) — Publicações por OAB, parte ou processo, monitores e prazos. (1 crédito por página de busca)
• API de licitações (editais abertos) — Editais abertos, itens, análise por IA e alertas. (1 crédito por página)
• API de imóveis (cadastro municipal) — Ficha do lote do cadastro da prefeitura — 7 cidades. (5 créditos por ficha, a partir do Builder)
• Servidor MCP (conector para IAs) — Conector para Claude, ChatGPT, Cursor e outras IAs. (O custo de cada ferramenta é o da rota)
• Webhooks — Eventos assinados com HMAC: intimação, edital, empresa nova. (Sem custo por entrega)

Todas as APIs e os planos