Busca dados do Simples Nacional em lote

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: Authorization: Bearer SEU_TOKEN.

Exemplo de requisição

Substitua os valores de exemplo pelos dados da sua consulta. O código não executa uma chamada automaticamente.

cURL

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

Envie Accept: application/json para solicitar JSON. Autenticação e limites também podem gerar erros antes da execução da operação. Consulte o guia de tratamento de erros.

Resposta de sucesso

Exemplo estrutural gerado do schema: os valores abaixo são ilustrativos, não representam uma consulta real. Campos anuláveis podem retornar null.

JSON · estrutura ilustrativa

[
  {
    "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	—

Contrato desta operação

OpenAPI · JSON

{
  "tags": [
    "CNPJ"
  ],
  "summary": "Busca dados do Simples Nacional em lote",
  "description": "Pesquisa por uma lista de CNPJs informada no corpo da requisição e retorna os dados do Simples Nacional dos estabelecimentos localizados.\n\n- Limite de 100 CNPJs por requisição.\n- Cada registro localizado consome 1 crédito.\n- Disponível somente nos planos pagos.",
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/BatchCnpjRequest"
        }
      },
      "text/json": {
        "schema": {
          "$ref": "#/components/schemas/BatchCnpjRequest"
        }
      },
      "application/*+json": {
        "schema": {
          "$ref": "#/components/schemas/BatchCnpjRequest"
        }
      }
    }
  },
  "responses": {
    "200": {
      "description": "Operação realizada com sucesso",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CnpjSimplesResponse"
            }
          }
        },
        "text/xml": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CnpjSimplesResponse"
            }
          }
        }
      }
    },
    "400": {
      "description": "Erro nos parametros informados na requisição",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        },
        "text/xml": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        }
      }
    },
    "500": {
      "description": "Erro ao processar a requisição",
      "content": {
        "application/json": {
          "schema": {}
        },
        "text/xml": {
          "schema": {}
        }
      }
    }
  },
  "parameters": [],
  "method": "POST",
  "path": "/v1/cnpj/batch/simples",
  "slug": "post-v1-cnpj-batch-simples"
}