API de consulta em lote de CPF e CNPJ
Envie de 1 a 100 CPFs e CNPJs num só pedido e receba o resultado na URL de webhook do seu sistema, com assinatura HMAC-SHA256. Cada CPF ou CNPJ válido consome 1 requisição do seu limite diário.
curl -X POST https://api.datax.plus/v1/bureau/lote \
-H "api-key: $DATAX_KEY" \
-H "Content-Type: application/json" \
-d '{
"cpfs": ["12345678909"],
"cnpjs": ["11222333000181"],
"webhookUrl": "https://seu-sistema.com.br/webhooks/datax",
"webhookSecret": "um-segredo-com-16-ou-mais-caracteres"
}'
const res = await fetch("https://api.datax.plus/v1/bureau/lote", {
method: "POST",
headers: { "api-key": KEY, "Content-Type": "application/json" },
body: JSON.stringify({
cpfs: ["12345678909"],
cnpjs: ["11222333000181"],
webhookUrl: "https://seu-sistema.com.br/webhooks/datax",
webhookSecret: "um-segredo-com-16-ou-mais-caracteres",
}),
});
import requests
r = requests.post(
"https://api.datax.plus/v1/bureau/lote",
headers={"api-key": KEY},
json={
"cpfs": ["12345678909"],
"cnpjs": ["11222333000181"],
"webhookUrl": "https://seu-sistema.com.br/webhooks/datax",
"webhookSecret": "um-segredo-com-16-ou-mais-caracteres",
},
)
Um pedido, até 100 itens, entrega por webhook
-
01
Envie o pedido
Faça um POST com os CPFs e os CNPJs, de 1 a 100 itens somados, e a URL do seu webhook.
POST /v1/bureau/lote -
02
A DataX processa
O processamento é assíncrono. Não há consulta do resultado por polling.
webhookUrl -
03
Receba no webhook
O resultado chega na URL que você informou, com assinatura HMAC-SHA256.
webhookSecret
Onde o lote entra
-
Atualização de base
Envie a sua base aos poucos, de 100 em 100, sem fazer uma chamada para cada item.
-
Cadastros em massa
Enriqueça de uma vez uma lista de novos clientes, com CPFs e CNPJs no mesmo pedido.
-
Integração por evento
O seu sistema recebe o resultado pelo webhook, sem precisar ficar consultando.
Como montar o pedido
O exemplo usa valores fictícios. Para detalhes da entrega no webhook, fale com o suporte pelo Telegram.
- Cabeçalho
api-key: a chave de API gerada no portal. Obrigatório em todas as chamadas.- Limite
- De 1 a 100 itens por pedido, somando CPFs e CNPJs.
- Entrega
- Assíncrona, na URL de webhook informada, com assinatura HMAC-SHA256. Sem polling.
- Consumo
- 1 requisição do limite diário por CPF ou CNPJ válido.
| Campo | O que é |
|---|---|
cpfs | Lista de CPFs, só números |
cnpjs | Lista de CNPJs, só números |
webhookUrl | URL HTTPS do seu sistema que vai receber o resultado |
webhookSecret | Segredo de 16 a 128 caracteres para você validar que a entrega veio da DataX. Opcional |
O lote está no plano Avançado
Cada CPF ou CNPJ válido consome 1 requisição do limite diário. O lote não está no teste grátis nem nos planos Entrada e Intermediário. Ver todos os planos.
| Plano | Preço | Chamadas/dia | Chamadas/min | Custo por chamada |
|---|---|---|---|---|
| Avançado | R$ 599/mês | 20.000 | 300 | R$ 0,0010 |
O custo por chamada considera o uso de todo o limite diário por 30 dias.
Perguntas sobre a API de consulta em lote
Quantos itens cabem em um pedido?
De 1 a 100 itens, somando CPFs e CNPJs. Para listas maiores, divida em vários pedidos.
Como recebo o resultado?
O processamento é assíncrono: o resultado é entregue na URL de webhook que você informar. Não há consulta do resultado por polling.
Como sei que a entrega veio da DataX?
A entrega é assinada com HMAC-SHA256. Envie um webhookSecret de 16 a 128 caracteres para validar a assinatura. Para detalhes da entrega, fale com o suporte pelo Telegram.
Como o lote é contado no limite?
Cada CPF ou CNPJ válido consome 1 requisição do limite diário: um pedido com 100 itens válidos consome 100.
Quais planos têm o lote?
Só o Avançado (R$ 599/mês, 20.000 chamadas/dia). Usando todo o limite diário por 30 dias, cada item sai por cerca de R$ 0,0010.
Posso usar esses dados de acordo com a LGPD?
Os dados retornados são dados pessoais. Pela LGPD, cada uso precisa de uma finalidade legítima e de uma base legal, como o legítimo interesse ou a proteção do crédito, e cabe a cada empresa definir as duas para o seu caso. Na dúvida, fale com o seu jurídico.
Outras consultas da API
-
API de consulta de CNPJ
Ficha cadastral da empresa e quadro societário.
-
API de consulta de CPF
Dados cadastrais, telefones, e-mails e endereços da pessoa.
-
API de sócios de um CNPJ
Telefone e e-mail de cada sócio pessoa física da empresa.