CNPJAPI

Consultar Inscrição Estadual (IE) pela API

A CNPJAPI consulta a Inscrição Estadual (IE) de um CNPJ na fonte oficial - o cadastro de contribuintes de ICMS das SEFAZ, por webservice, não raspagem. A consulta exige autenticação: a sua API key precisa de um plano com cota de IE - todo plano registrado inclui uma, o gratuito também. Este guia mostra a chamada e como ler a resposta.

Endpoint

  • Método e caminho: GET /consulta/ie/{cnpj} (apenas os 14 dígitos, sem pontuação)
  • Base URL: https://api.cnpjapi.com.br
  • uf (opcional): uma UF (ex.: SP) custa 1 crédito; omitir faz a varredura nacional nas UFs cobertas e custa 3 créditos.
  • Autenticação: API key no cabeçalho Authorization: Bearer (veja Autenticação).

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

Exemplo (curl)

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

Exemplo em código

Os exemplos Node usam fetch nativo (Node 18+) e await no nível superior - rode como módulo ES (arquivo .mjs, ou "type": "module" no package.json), ou envolva o código numa função async.

Python:

import requests

cnpj = "00776574000156"
r = requests.get(
    f"https://api.cnpjapi.com.br/consulta/ie/{cnpj}",
    params={"uf": "SP"},              # omita para a varredura nacional
    headers={"Authorization": "Bearer cnpj_sua_chave"},
)
r.raise_for_status()
for ie in r.json()["resultados"]:
    print(ie["uf"], ie["ie"], ie["situacao"])

Node.js:

const cnpj = "00776574000156";
const resposta = await fetch(
  `https://api.cnpjapi.com.br/consulta/ie/${cnpj}?uf=SP`, // omita ?uf para varrer o país
  { headers: { Authorization: "Bearer cnpj_sua_chave" } },
);
const { resultados } = await resposta.json();
for (const ie of resultados) {
  console.log(ie.uf, ie.ie, ie.situacao);
}

Lendo a resposta

Cada item de resultados traz uf, ie (número, vazio quando não-contribuinte), indicador (1 contribuinte de ICMS, 2 isento, 9 não-contribuinte), situacao (habilitado/nao_habilitado), razao_social e mais.

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

Os campos completos estão em Consultar a Inscrição Estadual.

Cota, créditos e disponibilidade

  • A IE tem cota mensal própria por plano, separada da cota de consulta de CNPJ. Créditos avulsos não expiram.
  • Respostas de cache (24h) não debitam crédito.
  • O status da consulta por estado fica em Disponibilidade por UF.

Junto com os dados do CNPJ

Precisa do cadastro e da IE numa só chamada? Use GET /{cnpj}?incluir=ie - a resposta do CNPJ ganha o campo inscricoes_estaduais. Só no formato nativo. Veja Consultar um CNPJ.

Próximos passos

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