# Busca Inscrições Estaduais do CNPJ

> Parâmetros, exemplos e respostas de GET /v1/cnpj/{cnpj}/ie na NextAPI.

Fonte: https://www.nextapi.com.br/docs/api/get-v1-cnpj-cnpj-ie

`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: cabeçalho `Authorization: Bearer SEU_TOKEN`.

## Exemplo de requisição

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

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",
    "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 | — |