Busca Empresas

GET/v1/empresas

Busca Empresas e Estabelecimentos cadastrados na Receita Federal com filtros avançados. - O resultado da consulta é paginado com limite de até 100 itens por página (padrão 20) e 5.000 itens totais. - Cada consulta 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 GET 'https://api.nextapi.com.br/v1/empresas' \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Accept: application/json'

Parâmetros

Nome	Local	Obrigatório	Tipo / regras	Descrição
`uf`	query	Não	`string`	Sigla do estado para filtro (ex: SP, RJ)
`codigoMunicipio`	query	Não	`string`	Código(s) do município, separados por vírgula (ex: 3550308,3304557)
`cnpjRaiz`	query	Não	`string`	CNPJ raiz (8 primeiros dígitos) para filtro
`cnpj`	query	Não	`string`	Número completo do CNPJ para filtro (somente dígitos)
`q`	query	Não	`string`	Busca pelo início da Razão Social ou Nome Fantasia (mínimo 3 caracteres)
`dataAberturaInicio`	query	Não	`string (date-time)`	Data de abertura inicial do intervalo de filtro (formato: yyyy-MM-dd)
`dataAberturaFim`	query	Não	`string (date-time)`	Data de abertura final do intervalo de filtro (formato: yyyy-MM-dd)
`codigoSituacaoCadastral`	query	Não	`string`	Código(s) de situação cadastral separados por vírgula (01=Nula, 02=Ativa, 03=Suspensa, 04=Inapta, 08=Baixada)
`ceps`	query	Não	`string`	CEP(s) para filtro, separados por vírgula
`cnaes`	query	Não	`string`	Código(s) CNAE (somente números) para filtro, separados por vírgula
`page`	query	Não	`integer (int32)`	Número da página (padrão: 1)
`pageSize`	query	Não	`integer (int32)`	Quantidade de itens por página (máx: 200)

Respostas HTTP

Status	Descrição	Formato JSON
`200`	Operação realizada com sucesso	CnpjSimplifiedResponsePagedResult
`400`	Erro nos parametros informados na requisição	IErrorCodeModel
`405`	Falta de créditos para realizar a consulta	IErrorCodeModel
`500`	Erro ao processar a requisição	IErrorCodeModel

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

{
  "page": 0,
  "pageSize": 0,
  "total": 0,
  "items": [
    {
      "cnpj": "string",
      "razaoSocial": "string",
      "situacaoCadastral": "string",
      "uf": "string"
    }
  ]
}

Campos da resposta

Modelo: CnpjSimplifiedResponsePagedResult

CnpjSimplifiedResponsePagedResult

Campo	Tipo	Obrigatório	Descrição / regras
`page`	`integer (int32)`	Não marcado no contrato	—
`pageSize`	`integer (int32)`	Não marcado no contrato	—
`total`	`integer (int64)`	Não marcado no contrato	—
`items`	`CnpjSimplifiedResponse[]`	Não marcado no contrato	—

CnpjSimplifiedResponse

Campo	Tipo	Obrigatório	Descrição / regras
`cnpj`	`string \| null`	Não marcado no contrato	—
`razaoSocial`	`string \| null`	Não marcado no contrato	—
`situacaoCadastral`	`string \| null`	Não marcado no contrato	—
`uf`	`string \| null`	Não marcado no contrato	—

Contrato desta operação

OpenAPI · JSON

{
  "tags": [
    "Empresas"
  ],
  "summary": "Busca Empresas",
  "description": "Busca Empresas e Estabelecimentos cadastrados na Receita Federal com filtros avançados.\n\n- O resultado da consulta é paginado com limite de até 100 itens por página (padrão 20) e 5.000 itens totais.\n- Cada consulta consome **1 crédito**.\n- Disponível somente nos planos pagos.",
  "parameters": [
    {
      "name": "uf",
      "in": "query",
      "description": "Sigla do estado para filtro (ex: SP, RJ)",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "codigoMunicipio",
      "in": "query",
      "description": "Código(s) do município, separados por vírgula (ex: 3550308,3304557)",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "cnpjRaiz",
      "in": "query",
      "description": "CNPJ raiz (8 primeiros dígitos) para filtro",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "cnpj",
      "in": "query",
      "description": "Número completo do CNPJ para filtro (somente dígitos)",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "q",
      "in": "query",
      "description": "Busca pelo início da Razão Social ou Nome Fantasia (mínimo 3 caracteres)",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "dataAberturaInicio",
      "in": "query",
      "description": "Data de abertura inicial do intervalo de filtro (formato: yyyy-MM-dd)",
      "schema": {
        "type": "string",
        "format": "date-time"
      }
    },
    {
      "name": "dataAberturaFim",
      "in": "query",
      "description": "Data de abertura final do intervalo de filtro (formato: yyyy-MM-dd)",
      "schema": {
        "type": "string",
        "format": "date-time"
      }
    },
    {
      "name": "codigoSituacaoCadastral",
      "in": "query",
      "description": "Código(s) de situação cadastral separados por vírgula (01=Nula, 02=Ativa, 03=Suspensa, 04=Inapta, 08=Baixada)",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "ceps",
      "in": "query",
      "description": "CEP(s) para filtro, separados por vírgula",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "cnaes",
      "in": "query",
      "description": "Código(s) CNAE (somente números) para filtro, separados por vírgula",
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "page",
      "in": "query",
      "description": "Número da página (padrão: 1)",
      "schema": {
        "type": "integer",
        "format": "int32"
      }
    },
    {
      "name": "pageSize",
      "in": "query",
      "description": "Quantidade de itens por página (máx: 200)",
      "schema": {
        "type": "integer",
        "format": "int32"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Operação realizada com sucesso",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/CnpjSimplifiedResponsePagedResult"
          }
        },
        "text/xml": {
          "schema": {
            "$ref": "#/components/schemas/CnpjSimplifiedResponsePagedResult"
          }
        }
      }
    },
    "400": {
      "description": "Erro nos parametros informados na requisição",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        },
        "text/xml": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        }
      }
    },
    "405": {
      "description": "Falta de créditos para realizar a consulta",
      "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": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        },
        "text/xml": {
          "schema": {
            "$ref": "#/components/schemas/IErrorCodeModel"
          }
        }
      }
    }
  },
  "method": "GET",
  "path": "/v1/empresas",
  "slug": "get-v1-empresas"
}