# API de consulta em lote de CPF e CNPJ

> Versão em Markdown de https://datax.plus/api-lote-cpf-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.

[Assinar o plano Avançado](https://portal.datax.plus/auth/cadastro) [Ver na documentação](https://datax.plus/docs/#lote)

● No plano Avançado · R$ 599/mês, sem fidelidade. Não está no teste grátis.

```bash
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"
  }'
```

```javascript
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",
  }),
});
```

```python
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

1. **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`

2. **A DataX processa**

   O processamento é assíncrono. Não há consulta do resultado por polling.

   `webhookUrl`

3. **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](https://t.me/DataXSuporteBot).

**POST** `https://api.datax.plus/v1/bureau/lote`

- **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.

Por [Equipe DataX](https://datax.plus/) · Atualizada em 4 de novembro de 2026

| Campo | O que é |
| --- | --- |
| `cpfs` | Lista de CPFs, só números |
| `cnpjs` | Lista de CNPJs, numéricos ou alfanuméricos, sem pontuação |
| `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 |

[Ver na documentação completa →](https://datax.plus/docs/#lote)

## 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](https://datax.plus/#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](https://t.me/DataXSuporteBot).

### 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](https://datax.plus/api-consulta-cnpj/)**

  Ficha cadastral da empresa e quadro societário.

- **[API de consulta de CPF](https://datax.plus/api-consulta-cpf/)**

  Dados cadastrais, telefones, e-mails e endereços da pessoa.

- **[API de sócios de um CNPJ](https://datax.plus/api-socios-cnpj/)**

  Telefone e e-mail de cada sócio pessoa física da empresa.

[Ver todas as consultas na documentação →](https://datax.plus/docs/)

Guias: [como enriquecer uma planilha de CNPJs →](https://datax.plus/guias/enriquecer-planilha-cnpj-api/)

## O lote está no plano Avançado, sem fidelidade.

[Assinar o plano Avançado](https://portal.datax.plus/auth/cadastro) [Ver os planos](https://datax.plus/#planos)