Consultar a Inscrição Estadual (IE)

A CNPJAPI consulta a Inscrição Estadual de um CNPJ direto na fonte oficial (o cadastro das Secretarias da Fazenda estaduais, por webservice - não é raspagem). É um recurso premium: exige uma API key de um plano com cota de IE.

Método e caminho: GET /consulta/ie/{cnpj}
Base URL: https://api.cnpjapi.com.br
Parâmetro de caminho: apenas os 14 dígitos do CNPJ, sem pontuação.
Autenticação: API key no cabeçalho Authorization (veja Autenticação). Não há versão anônima; o plano precisa incluir IE.

Parâmetros de consulta

Parâmetro	Descrição
`uf`	UF alvo (ex.: `SP`). Omitido = varredura nacional nas UFs cobertas.
`incluir_baixadas`	`true` inclui também as inscrições baixadas (não habilitadas). Padrão `false`: devolve só as ativas (contribuinte ou isento).

Cobertura (16 UFs): AC, AM, BA, ES, GO, MT, MS, MG, PB, PR, PE, RJ, RN, RS, SC, SP.

Numa consulta por uf, se o CNPJ não é contribuinte naquele estado o item ainda é devolvido, com indicador: 9 e ie vazio (é a resposta definitiva para a UF perguntada) - não confunda "não-contribuinte" com "lista vazia". Já na varredura nacional os não-contribuintes são omitidos: só entram as UFs onde há inscrição.

Exemplo (curl)

Uma UF:

curl "https://api.cnpjapi.com.br/consulta/ie/00776574000156?uf=SP" \
  -H "Authorization: Bearer cnpj_sua_chave"

Varredura nacional (sem uf):

curl "https://api.cnpjapi.com.br/consulta/ie/00776574000156" \
  -H "Authorization: Bearer cnpj_sua_chave"

Resposta (`200 OK`, `application/json`)

{
  "cnpj": "00776574000156",
  "fonte": "sefaz",
  "cache_hit": false,
  "as_of": "2026-09-04T12:00:00Z",
  "resultados": [
    {
      "uf": "SP",
      "ie": "111111111111",
      "indicador": 1,
      "situacao": "habilitado",
      "tipo": "sede",
      "razao_social": "...",
      "nome_fantasia": "...",
      "data_baixa": null
    }
  ]
}

Campos da resposta

Campo	Descrição
`cnpj`	CNPJ consultado (14 dígitos)
`fonte`	Origem do dado (`sefaz`)
`cache_hit`	`true` quando servido do cache de 24h (não debita crédito)
`as_of`	Instante do dado (ISO-8601)
`resultados`	Lista de inscrições, uma por UF encontrada

Cada item de resultados:

Campo	Descrição
`uf`	Unidade federativa da inscrição
`ie`	Número da Inscrição Estadual (vazio quando não-contribuinte)
`indicador`	`1` contribuinte de ICMS, `2` isento, `9` não-contribuinte
`situacao`	`habilitado` ou `nao_habilitado`
`tipo`	`sede` (a IE na UF da sede) ou `outra_uf` (inscrição em outro estado)
`razao_social`	Razão social conforme o cadastro estadual
`nome_fantasia`	Nome fantasia, quando houver
`data_baixa`	Data de baixa da IE quando `nao_habilitado`; `null` caso contrário

Créditos e cota

Varredura nacional (sem uf) custa 3 créditos; uma UF específica (?uf=SP) custa 1 crédito.
Respostas de cache (cache_hit: true) não debitam crédito.
A IE tem cota mensal própria por plano, separada da cota de consulta de CNPJ; alguns planos permitem também créditos avulsos, que não expiram. Gerencie tudo no portal.

Junto com os dados do CNPJ

Precisa dos dados cadastrais e da IE numa só chamada? Use GET /{cnpj}?incluir=ie - a resposta do CNPJ ganha o campo inscricoes_estaduais (mesmo formato de resultados acima). Detalhe em Consultar um CNPJ. Só no formato nativo (a compatibilidade ReceitaWS ignora o parâmetro).

Erros

Status	Significado
`401`	API key ausente ou inválida
`403`	Seu plano não inclui consultas de Inscrição Estadual
`422`	CNPJ inválido, ou `uf` fora da cobertura
`429`	Cota mensal de IE ou rate limit excedidos - respeite o `Retry-After`
`502`	Fonte oficial (SEFAZ) indisponível no momento - tente de novo
`503`	Serviço temporariamente indisponível - tente de novo

Veja todos os códigos em Erros.

Próximos passos

Consultar um CNPJ - os dados cadastrais, com opção ?incluir=ie.
Autenticação - gere sua API key.
Limites e planos - compare os planos com IE.
Erros - o que cada código significa.
Disponibilidade por UF - o status da consulta de IE em cada estado.

Crie sua conta em https://app.cnpjapi.com.br e assine um plano com IE para começar.