Consulta de CPF em lote por CSV ou API.

Consulte até 100 CPFs por envio. Cole uma lista, importe um arquivo CSV ou TXT ou use a API. Cada registro encontrado consome um crédito.

Como preparar a planilha para consultar CPFs?

Organize o trabalho da equipe sem abrir uma consulta por vez. Cole uma lista ou importe um arquivo CSV/TXT de uma coluna, com até 100 documentos por envio. O painel apresenta o resultado de cada entrada.

  1. Prepare a coluna de documentos.

    Use texto para preservar zeros iniciais. O cabeçalho cpf é opcional. Cada linha deve conter somente um número, com ou sem pontuação.

  2. Revise antes de enviar.

    Confira o total, remova duplicados quando fizer sentido e verifique os números inválidos. Um documento repetido representa outra consulta; não conte com deduplicação automática.

  3. Consulte e acompanhe o saldo.

    Cada registro encontrado consome um crédito. Revise os resultados no painel e exporte a relação com os documentos mascarados.

Abrir consultas em lote
Sua lista
Coluna Acpf11 dígitos por linhaCSV ou TXT · até 100 documentos
Encontrado1 crédito
Não encontrado0 créditos
Inválido0 créditos

Resultados organizados para revisar e exportar.

Como tratar cada resultado?

ResultadoO que significaPróximo passo
EncontradoHá um registro na base disponível.Confira os campos retornados com o cadastro da sua operação.
Não encontradoA busca não localizou um registro.Revise a entrada. A ausência não comprova que o documento é inexistente ou irregular.
InválidoO número não passou na validação dos dígitos.Corrija a origem do dado antes de tentar novamente.

Se o saldo não cobrir os resultados encontrados do lote, a operação é recusada sem cobrança parcial. Adicione créditos e envie novamente. O saldo é compartilhado entre consultas individuais, lotes e API.

Como consultar CPFs em lote pela API?

Use POST /api/v1/lotes com um objeto JSON contendo cpfs, uma lista de até 100 strings. A resposta preserva a ordem de entrada e inclui o saldo e a data da consulta. Mantenha a chave no servidor e implemente uma fila para volumes maiores.

Ver limites e tratamento de respostas

Uma consulta, uma finalidade.

Envie somente os dados necessários para sua operação. Restrinja o acesso da equipe, defina o prazo de uso dos resultados e mantenha arquivos exportados em um local controlado.

Como protegemos os dados

Quanto custa uma consulta em lote?

O tamanho do arquivo não define sozinho o consumo. Uma lista com 100 números e 60 registros encontrados usa 60 créditos. Veja a franquia adequada ao volume que sua equipe consulta.

Comparar volumes e preços