Consulta de CPF em lote: até 1.000 CPFs por envio
Envie a lista inteira em uma chamada e acompanhe o andamento ou receba um aviso por webhook quando terminar. Ideal para higienizar bases e conferir cadastros em massa.
Só os CPFs encontrados consomem crédito. Sandbox sem custo.
Andamento do lote
- Total
- 1.000 CPFs
- Processados
- 1.000
- Encontrados
- 968
- Não encontrados
- 32
Feito para volume
A mesma consulta oficial do CPF, sem precisar controlar milhares de chamadas.
- Até 1.000 CPFs por envio
- Cada item leva o CPF e a data de nascimento. CPFs repetidos na lista contam uma vez.
- Processamento assíncrono
- A API responde 202 na hora com um batch_id e processa a lista em segundo plano, sem prender a sua aplicação.
- Aviso por webhook
- Cadastre um webhook e receba o evento batch.completed ao terminar, só com contadores e datas, sem dados pessoais.
- Resultados paginados
- Cada item volta com status (encontrado, não encontrado, inválido ou erro) e, quando achado, os dados do CPF.
- Retentativa só do que falhou
- Itens inválidos, não encontrados ou com falha do provedor não cobram, e você reenvia apenas esses.
- Mesmas regras da consulta unitária
- Mesmo saldo, mesmo limite de requisições do plano e mesma resposta por item.
Como funciona
- 1
Você envia a lista
A API valida cada item e reserva o processamento. A resposta 202 traz o batch_id.
- 2
Resolvemos em segundo plano
O que já foi consultado recentemente é resolvido na hora. O restante segue para a fonte oficial.
- 3
Você acompanha e lê os resultados
Consulte o andamento até o status ser completed, ou espere o webhook. Os resultados ficam disponíveis por 24 horas.
Envie a lista, acompanhe depois
Um POST com a lista de CPFs e datas de nascimento devolve o batch_id para acompanhar.
Documentação do endpointcURL POST /v1/cpf/batch
Resposta
Lote aceito. Acompanhe pelo batch_id.
Saldo insuficiente para cobrir o lote: nada foi processado.
Quanto custa
1 crédito por CPF encontrado
Inválidos, não encontrados e falhas do provedor não cobram. O saldo precisa cobrir o lote inteiro, a menos que o plano permita excedente.
Sandbox sem custo
No sandbox o lote roda com CPFs de teste, inclusive um lote misto de exemplo, sem debitar créditos.
Mesmo saldo das outras consultas
Os créditos do plano valem para CPF, CNPJ, lotes e dossiê. O lote respeita o limite de requisições da conta.
Onde usar
Higienização de base
Confira milhares de cadastros de uma vez e encontre CPFs suspensos, cancelados ou com dados que não batem.
Migração de sistemas
Valide o cadastro inteiro antes de importar clientes para uma nova plataforma.
Cobrança e recuperação
Atualize a situação cadastral de uma carteira inteira em uma única rodada.
Perguntas frequentes
Qual o tamanho máximo do lote?
Até 1.000 itens por envio. Para listas maiores, envie vários lotes em sequência; a conta tem um limite de itens aguardando processamento para proteger a fila.
Em quanto tempo o lote termina?
Depende do tamanho e de quantos CPFs já foram consultados recentemente. Acompanhe pelo status do lote ou receba o webhook batch.completed quando terminar.
Por quanto tempo os resultados ficam disponíveis?
Por 24 horas depois do envio. Depois disso, o lote some e é preciso consultar de novo.
Quem paga pelos CPFs que não foram encontrados?
Ninguém: só os CPFs encontrados consomem crédito. Inválidos, não encontrados e falhas do provedor não são cobrados.
E se meu saldo acabar no meio do lote?
A API confere o saldo antes de começar e responde 402 se ele não cobre o lote (a menos que o plano permita excedente). O lote não começa pela metade.
Outros produtos da BrazID
Todos usam a mesma chave de API e o mesmo saldo de créditos.
Confira milhares de CPFs de uma vez
Crie sua conta, teste o lote no sandbox e processe sua base com a chave de produção.
Só os CPFs encontrados consomem crédito. Sandbox sem custo.