Consulta em lote
Consulta de CPF em lote para limpar base
Envie até 10.000 CPFs por job, acompanhe o status e baixe/consuma o resultado. Só consultas encontradas consomem crédito.
POST /cpf/bulk
Body JSON { "cpfs": string[] }. Máximo de 10.000 CPFs por job. Entrada com ou sem máscara.
Poll GET /cpf/bulk/{jobId}
Job assíncrono: o POST devolve jobId. Consulte o status até done ou failed.
Upload no dashboard
Sem código: envie CSV/TXT em app.cpfhub.io e exporte o resultado pelo painel.
Pay-on-found
Só consultas encontradas (found: true) consomem 1 crédito. 404 e inválidos não cobram.
Exemplo
Dois passos: envie o lote e consulte o job
Job assíncrono. Só itens encontrados consomem crédito. Também há upload no dashboard.
FAQ
Perguntas frequentes
Qual o limite por job?
Até 10.000 CPFs por requisição em POST /cpf/bulk. Acima disso a API recusa com 400. Para volumes maiores, divida em vários jobs ou fale com o Corporativo.
É síncrono ou assíncrono?
Assíncrono. O POST cria o job e devolve um jobId. Faça poll em GET /cpf/bulk/{jobId} até o status done ou failed. O dashboard também acompanha o progresso.
404 consome crédito?
Não. No lote, só itens com found: true consomem crédito. CPF não encontrado ou inválido não cobra. A mesma regra vale no GET individual (só HTTP 200).
Dá para usar lote no Grátis?
Sim. O Grátis acessa os mesmos endpoints, com 50 créditos/mês. Em 0 créditos, itens do lote são skipped (sem overage no Grátis). Pro e Corporativo cobrem volumes maiores — veja /precos.
Ainda tem dúvidas?
Entre em ContatoLimpe a base
em lote.
Até 10.000 CPFs por job. Painel ou API. Só found consome crédito.
Acesso imediato à API Key e documentação.