Busca Inscrições Estaduais do CNPJ

GET/v1/cnpj/{cnpj}/ie

Retorna as Inscrições Estaduais (IE) disponíveis para o CNPJ informado. - Um CNPJ pode possuir mais de uma IE (uma por UF), por isso a resposta é uma lista. - Dado essencial para emissão de Nota Fiscal. - A cobertura é limitada aos estados que publicam a base pública de Inscrições Estaduais: atualmente SP, PR e MG. CNPJs de outras UFs, ou sem IE registrada, retornam lista vazia. - Cada consulta consome 1 crédito. Disponível em todos os planos.

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/cnpj/SEU_CNPJ/ie' \
  --header 'Authorization: Bearer SEU_TOKEN' \
  --header 'Accept: application/json'

Parâmetros

Nome	Local	Obrigatório	Tipo / regras	Descrição
`cnpj`	path	Sim	`string`	Número do CNPJ (somente dígitos, ex: 00000000000191)

Respostas HTTP

Status	Descrição	Formato JSON
`200`	Operação realizada com sucesso	CnpjInscricaoEstadualResponse[]
`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	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",
    "inscricaoEstadual": "string",
    "uf": "string",
    "situacao": "string",
    "cnae": "string",
    "municipio": "string",
    "dataAtualizacao": "string"
  }
]

Campos da resposta

Modelo: CnpjInscricaoEstadualResponse[]

CnpjInscricaoEstadualResponse

Campo	Tipo	Obrigatório	Descrição / regras
`cnpj`	`string \| null`	Não marcado no contrato	—
`inscricaoEstadual`	`string \| null`	Não marcado no contrato	—
`uf`	`string \| null`	Não marcado no contrato	—
`situacao`	`string \| null`	Não marcado no contrato	—
`cnae`	`string \| null`	Não marcado no contrato	—
`municipio`	`string \| null`	Não marcado no contrato	—
`dataAtualizacao`	`string \| null`	Não marcado no contrato	—

Contrato desta operação

OpenAPI · JSON

{
  "tags": [
    "CNPJ"
  ],
  "summary": "Busca Inscrições Estaduais do CNPJ",
  "description": "Retorna as Inscrições Estaduais (IE) disponíveis para o CNPJ informado.\n\n- Um CNPJ pode possuir mais de uma IE (uma por UF), por isso a resposta é uma lista.\n- Dado essencial para emissão de Nota Fiscal.\n- A cobertura é limitada aos estados que publicam a base pública de Inscrições Estaduais: atualmente **SP, PR e MG**. CNPJs de outras UFs, ou sem IE registrada, retornam lista vazia.\n- Cada consulta consome 1 crédito. Disponível em todos os planos.",
  "parameters": [
    {
      "name": "cnpj",
      "in": "path",
      "description": "Número do CNPJ (somente dígitos, ex: 00000000000191)",
      "required": true,
      "schema": {
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Operação realizada com sucesso",
      "content": {
        "application/json": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CnpjInscricaoEstadualResponse"
            }
          }
        },
        "text/xml": {
          "schema": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CnpjInscricaoEstadualResponse"
            }
          }
        }
      }
    },
    "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": {}
        },
        "text/xml": {
          "schema": {}
        }
      }
    }
  },
  "method": "GET",
  "path": "/v1/cnpj/{cnpj}/ie",
  "slug": "get-v1-cnpj-cnpj-ie"
}