API de inscrição estadual por UF (alternativa à consulta SINTEGRA)

GET /api/consultar?uf=XX devolve as inscrições estaduais de um CNPJ, CPF ou IE no estado informado, com situação (Habilitado ou Não habilitado), endereço, CNAE e regime de apuração, e conta como 1 consulta (de R$ 0,025 a R$ 0,67, conforme o plano).

Funciona nas 27 UFs. Para procurar em todos os estados de uma vez, pelo mesmo preço, use API do SINTEGRA: IE nos 27 estados.

Resumo

Quanto custa cada chamada

Valores por consulta dentro da franquia mensal. Depois dela, a recarga sai a R$ 0,12 (Starter), R$ 0,07 (Pro) ou R$ 0,02 (Enterprise). Erro HTTP não é cobrado, inclusive 502 e 503 quando o portal do estado falha. Resposta sem inscrição conta: é a resposta de que o documento não tem IE naquele estado. Veja Planos e limites.

Autenticação

Envie sua chave no header X-API-Key. Veja Autenticação para detalhes.

Parâmetros de consulta

Exemplos

Produtor rural por CPF em uma UF

curl -X GET "https://api.fiscalapi.com.br/api/consultar?uf=MT&cpf=12345678909" \
  -H "X-API-Key: fapi_sua_chave_aqui"

const response = await fetch(
  "https://api.fiscalapi.com.br/api/consultar?uf=MT&cpf=12345678909",
  { headers: { "X-API-Key": "fapi_sua_chave_aqui" } }
);
const data = await response.json();
console.log(data.results);

import requests

response = requests.get(
    "https://api.fiscalapi.com.br/api/consultar",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"uf": "MT", "cpf": "12345678909"},
)
data = response.json()
print(data["results"])

$response = Http::withHeaders([
    'X-API-Key' => 'fapi_sua_chave_aqui',
])->get('https://api.fiscalapi.com.br/api/consultar', [
    'uf' => 'MT',
    'cpf' => '12345678909',
]);
$data = $response->json();

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "fapi_sua_chave_aqui");
var response = await client.GetAsync(
    "https://api.fiscalapi.com.br/api/consultar?uf=MT&cpf=12345678909"
);
var data = await response.Content.ReadAsStringAsync();

Só uma UF por CNPJ

curl -X GET "https://api.fiscalapi.com.br/api/consultar?uf=SP&cnpj=12345678000195" \
  -H "X-API-Key: fapi_sua_chave_aqui"

const response = await fetch(
  "https://api.fiscalapi.com.br/api/consultar?uf=SP&cnpj=12345678000195",
  { headers: { "X-API-Key": "fapi_sua_chave_aqui" } }
);
const data = await response.json();
console.log(data.results);

import requests

response = requests.get(
    "https://api.fiscalapi.com.br/api/consultar",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"uf": "SP", "cnpj": "12345678000195"},
)
data = response.json()
print(data["results"])

$response = Http::withHeaders([
    'X-API-Key' => 'fapi_sua_chave_aqui',
])->get('https://api.fiscalapi.com.br/api/consultar', [
    'uf' => 'SP',
    'cnpj' => '12345678000195',
]);
$data = $response->json();

var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-API-Key", "fapi_sua_chave_aqui");
var response = await client.GetAsync(
    "https://api.fiscalapi.com.br/api/consultar?uf=SP&cnpj=12345678000195"
);
var data = await response.Content.ReadAsStringAsync();

Resposta

Campos de nível superior

Campos de cada resultado (results[])

Exemplo de resposta

{
  "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "document": "12345678909",
  "document_type": "cpf",
  "uf": "MT",
  "cached": false,
  "data_atualizacao": "2026-10-23T09:41:12-03:00",
  "results": [
    {
      "inscricao_estadual": "13.123.456-0",
      "razao_social": "JOAO DA SILVA FAZENDA SANTA MARIA",
      "nome_fantasia": "FAZENDA SANTA MARIA",
      "situacao_ie": "Habilitado",
      "uf_ie": "MT",
      "tipo_ie": "IE de Produtor Rural",
      "logradouro": "ROD MT-130 KM 42",
      "complemento": "ZONA RURAL",
      "bairro": "ZONA RURAL",
      "numero": "S/N",
      "municipio": "RONDONOPOLIS",
      "cep": "78700-000",
      "regime_pagamento": "NORMAL",
      "data_situacao": "15/03/2020",
      "situacao_contribuinte": "Sem restrição",
      "data_inicio_atividade": "01/06/2015",
      "cnae_codigo": "0111301",
      "cnae_descricao": "CULTIVO DE ARROZ",
      "cnaes_secundarios": null,
      "regime_apuracao_icms": "NORMAL",
      "situacao_nfe": "NFe",
      "cpf_cnpj": "123.456.789-09",
      "situacao_cadastral": ""
    }
  ]
}

Atividades secundárias

O campo cnaes_secundarios traz as atividades econômicas secundárias registradas pelo estado naquela inscrição. Ele vem em todo resultado.

Para buscar as atividades no estado, envie secundarias=true neste endpoint ou no Consultar IE em todos os estados:

curl -X GET "https://api.fiscalapi.com.br/api/consultar?uf=MT&cpf=12345678909&secundarias=true" \
  -H "X-API-Key: fapi_sua_chave_aqui"

Sem o parâmetro, a consulta não fica mais lenta e o campo traz o que já foi obtido em uma consulta anterior com secundarias=true, ou null. GO é exceção: as atividades vêm sempre, sem tempo a mais. Endpoints que apenas incluem as inscrições dentro de outro resultado, como o perfil do produtor, não fazem essa busca.

Cada item da lista tem:

O campo tem três valores possíveis, e a diferença entre eles importa:

Estados cobertos

Regras que valem para todos os estados cobertos:

• O resultado da consulta nunca falha por causa das atividades secundárias. Se o dado não puder ser obtido a tempo, o campo vem null e todos os outros campos vêm normalmente.
• null por falha momentânea não é definitivo. A consulta seguinte do mesmo documento com secundarias=true busca de novo só as atividades que faltaram, mesmo quando o restante do resultado vem do cache (cached: true). Depois de algumas tentativas sem sucesso para a mesma inscrição, o campo fica null até o cache do resultado vencer.
• Até 10 inscrições por UF em cada consulta, começando pelas habilitadas. Em um documento com mais inscrições na mesma UF, as excedentes vêm com null e são completadas nas consultas seguintes do mesmo documento com secundarias=true.
• Descrição padronizada. A descrição segue a tabela oficial de CNAE do IBGE, igual em todos os estados (código fora da tabela mantém a descrição do estado). Atividade que o estado lista mais de uma vez aparece uma vez só.

Exemplo com atividades secundárias

{
  "inscricao_estadual": "10.123.456-2",
  "razao_social": "JOAO DA SILVA",
  "situacao_ie": "Habilitado",
  "uf_ie": "GO",
  "cnae_codigo": "0115600",
  "cnae_descricao": "CULTIVO DE SOJA",
  "cnaes_secundarios": [
    { "codigo": "0111302", "descricao": "CULTIVO DE MILHO" },
    { "codigo": "0111301", "descricao": "CULTIVO DE ARROZ" }
  ]
}

Exemplo de inscrição sem atividade secundária

{
  "inscricao_estadual": "10.765.432-6",
  "uf_ie": "GO",
  "cnae_codigo": "0115600",
  "cnae_descricao": "CULTIVO DE SOJA",
  "cnaes_secundarios": []
}

Códigos de erro

Integração com ERPs

Não existe conector pronto: a integração é uma chamada HTTP GET com o header X-API-Key, feita de onde o seu sistema já fala com a internet, em geral no cadastro de clientes e fornecedores.

Perguntas frequentes

Existe API do SINTEGRA por estado?

Sim. GET /api/consultar com o parâmetro uf consulta a inscrição estadual em um estado e devolve em JSON a situação, o endereço, o CNAE e o regime. Para todos os estados numa chamada, use /api/consultar-ie-todos.

Quanto custa?

1 consulta por chamada: R$ 0,025 no Enterprise, R$ 0,065 no Pro, R$ 0,10 no Starter e R$ 0,67 no Lite, dentro da franquia. Erro HTTP não é cobrado.

Posso consultar só pelo número da IE?

Sim. Envie ie com a uf. Se não souber o estado, use /api/consultar-ie-todos?ie=..., que procura o número nos 27 estados.

O que significa "Não habilitado"?

A inscrição existe, mas não está apta a operar: pode estar suspensa, baixada ou cancelada. Quando o estado informa, o campo situacao_cadastral traz o detalhe, como Suspenso - NÃO HABILITADO ou Baixado - NÃO HABILITADO.

API de Inscrição Estadual em lote · Planos e preços