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

Cobertura (26 UFs): AC, AL, AM, AP, BA, CE, DF, ES, GO, MG, MS, MT, PA, PB, PE, PI, PR, RJ, RN, RO, RR, RS, SC, SE, SP, TO. Só o MA fica de fora (a SEFAZ-MA não oferece o serviço).

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",
  "DoCache": false,
  "ConsultadoEm": "2026-09-04T12:00:00Z",
  "Resultados": [
    {
      "UF": "SP",
      "IE": "111111111111",
      "Indicador": 1,
      "Situacao": "habilitado",
      "Tipo": "sede",
      "RazaoSocial": "...",
      "NomeFantasia": "...",
      "DataBaixa": null,
      "ConsultadoEm": "2026-09-04T12:00:00Z"
    }
  ],
  "UFsIndisponiveis": [],
  "UFsDaBase": []
}

Campos da resposta

Cada item de Resultados:

Quando a SEFAZ não responde

A SEFAZ de cada estado é sempre consultada primeiro. Se ela não responder (fora do ar ou lenta demais) e a CNPJ API já tiver consultado aquele CNPJ antes, a resposta traz o último dado consultado, em vez de erro:

• a UF aparece em UFsDaBase;
• cada resultado traz em ConsultadoEm a data em que foi obtido na SEFAZ.

O número da IE quase não muda, mas a situação (habilitada, baixada) pode ter mudado desde aquela data. Se a situação for decisiva para você (por exemplo, antes de emitir uma nota fiscal), confira UFsDaBase e ConsultadoEm e repita a consulta mais tarde.

Sem dado guardado, a consulta por UF responde 502, e na varredura a UF vai para UFsIndisponiveis.

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 (DoCache: true) não debitam crédito.
• A resposta com o último dado consultado (UFsDaBase) é cobrada como uma consulta normal. Ela não vai para o cache de 24h: repetir a consulta tenta a SEFAZ de novo e é cobrado de novo. UFs em UFsIndisponiveis, sem dado nenhum, não geram cobrança por si.
• 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 InscricoesEstaduais (mesmo formato de Resultados acima), além de InscricoesEstaduaisUFsDaBase e InscricoesEstaduaisUFsIndisponiveis. Detalhe em Consultar um CNPJ. Só no formato nativo (a compatibilidade ReceitaWS ignora o parâmetro).

Erros

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.