# Busca dados do Simples Nacional em lote

> Parâmetros, exemplos e respostas de POST /v1/cnpj/batch/simples na NextAPI.

Fonte: https://www.nextapi.com.br/docs/api/post-v1-cnpj-batch-simples

`POST /v1/cnpj/batch/simples`

Pesquisa por uma lista de CNPJs informada no corpo da requisição e retorna os dados do Simples Nacional dos estabelecimentos localizados.

- Limite de 100 CNPJs por requisição.
- Cada registro localizado consome 1 crédito.
- Disponível somente nos planos pagos.

URL base: `https://api.nextapi.com.br`. Autenticação: cabeçalho `Authorization: Bearer SEU_TOKEN`.

## Exemplo de requisição

```bash
curl --request POST 'https://api.nextapi.com.br/v1/cnpj/batch/simples' \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"cnpjs":["SEU_CNPJ"]}'
```

## Parâmetros

Esta operação não declara parâmetros de rota ou query no contrato.

## Corpo da requisição

Envie JSON com `Content-Type: application/json`. 

Modelo: `BatchCnpjRequest`

### BatchCnpjRequest

| Campo | Tipo | Obrigatório | Descrição / regras |
| --- | --- | --- | --- |
| `cnpjs` | `string[]` | Não marcado no contrato | — |

## Respostas HTTP

| Status | Descrição | Formato JSON |
| --- | --- | --- |
| `200` | Operação realizada com sucesso | CnpjSimplesResponse[] |
| `400` | Erro nos parametros informados na requisição | IErrorCodeModel |
| `500` | Erro ao processar a requisição | objeto |

Autenticação e limites também podem gerar erros antes da execução da operação. Veja o [guia de tratamento de erros](https://www.nextapi.com.br/docs/erros.md).

## Resposta de sucesso

Exemplo estrutural gerado do schema: os valores são ilustrativos. Campos anuláveis podem retornar `null`.

```json
[
  {
    "cnpj": "string",
    "opcaoPeloSimples": false,
    "dataOpcaoPeloSimples": "2026-01-01T00:00:00",
    "dataExclusaoDoSimples": "2026-01-01T00:00:00",
    "opcaoPeloMEI": false,
    "dataOpcaoPeloMEI": "2026-01-01T00:00:00",
    "dataExclusaoDoMEI": "2026-01-01T00:00:00",
    "dataAtualizacao": "string"
  }
]
```

## Campos da resposta

Modelo: `CnpjSimplesResponse[]`

### CnpjSimplesResponse

| Campo | Tipo | Obrigatório | Descrição / regras |
| --- | --- | --- | --- |
| `cnpj` | `string \| null` | Não marcado no contrato | — |
| `opcaoPeloSimples` | `boolean \| null` | Não marcado no contrato | — |
| `dataOpcaoPeloSimples` | `string (date-time) \| null` | Não marcado no contrato | — |
| `dataExclusaoDoSimples` | `string (date-time) \| null` | Não marcado no contrato | — |
| `opcaoPeloMEI` | `boolean \| null` | Não marcado no contrato | — |
| `dataOpcaoPeloMEI` | `string (date-time) \| null` | Não marcado no contrato | — |
| `dataExclusaoDoMEI` | `string (date-time) \| null` | Não marcado no contrato | — |
| `dataAtualizacao` | `string \| null` | Não marcado no contrato | — |