API de consulta de Inscrição Estadual (SINTEGRA) por UF

Consulta a Inscrição Estadual (IE) de um contribuinte em um estado específico via SEFAZ.

GET /api/consultar

Consulta a Inscrição Estadual de um contribuinte em um único estado a partir de CPF, CNPJ ou IE. A API retorna os dados cadastrais completos do contribuinte no estado informado, incluindo situação, endereço, CNAE e regime de apuração.

Autenticação

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

Parâmetros de consulta

Você deve informar exatamente um dos parâmetros cpf, cnpj ou ie. Enviar nenhum ou mais de um resultará em erro 400.

Name	Type	Required	Description
`uf`	string	Sim	Sigla do estado (ex: MT, SP, RJ). Deve ser um dos 27 estados suportados.
`cpf`	string	Não	CPF do contribuinte (somente números, 11 dígitos).
`cnpj`	string	Não	CNPJ do contribuinte (somente números, 14 dígitos).
`ie`	string	Não	Número da Inscrição Estadual.

Exemplos de código

Consulta por CPF

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

const response = await fetch(
  "https://api.fiscalapi.com.br/api/consultar?uf=MT&cpf=12345678900",
  { 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": "12345678900"},
)
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' => '12345678900',
]);
$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=12345678900"
);
var data = await response.Content.ReadAsStringAsync();

Consulta por CNPJ

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

const response = await fetch(
  "https://api.fiscalapi.com.br/api/consultar?uf=SP&cnpj=12345678000199",
  { 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": "12345678000199"},
)
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' => '12345678000199',
]);
$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=12345678000199"
);
var data = await response.Content.ReadAsStringAsync();

Resposta

Campos de nível superior

Campo	Tipo	Descrição
`request_id`	string	Identificador único da requisição (UUID).
`document`	string	Documento enviado na consulta.
`document_type`	string	Tipo do documento: `cpf`, `cnpj` ou `ie`.
`uf`	string	UF consultada.
`cached`	boolean	Indica se o resultado veio do cache.
`results`	array	Lista de inscrições estaduais encontradas.

Campos de cada resultado (`results[]`)

Campo	Tipo	Descrição
`inscricao_estadual`	string	Número da IE.
`razao_social`	string	Nome ou Razão Social do contribuinte.
`nome_fantasia`	string	Nome fantasia.
`situacao_ie`	string	Situação da IE: `ATIVA`, `BAIXADA`, `SUSPENSA`, etc.
`uf_ie`	string	UF da inscrição.
`tipo_ie`	string	Tipo da inscrição (ex: `PRODUTOR RURAL`).
`logradouro`	string	Logradouro do endereço.
`complemento`	string	Complemento do endereço.
`bairro`	string	Bairro.
`numero`	string	Número.
`municipio`	string	Município.
`cep`	string	CEP.
`regime_pagamento`	string	Regime de pagamento.
`data_situacao`	string	Data da situação cadastral.
`situacao_contribuinte`	string	Situação do contribuinte.
`data_inicio_atividade`	string	Data de início da atividade.
`cnae_codigo`	string	Código CNAE principal.
`cnae_descricao`	string	Descrição do CNAE principal.
`regime_apuracao_icms`	string	Regime de apuração do ICMS.
`situacao_nfe`	string	Habilitação para emissão de NF-e.
`cpf_cnpj`	string	Documento formatado.
`situacao_cadastral`	string	Situação cadastral.

Exemplo de resposta

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "document": "12345678900",
  "document_type": "cpf",
  "uf": "MT",
  "cached": false,
  "results": [
    {
      "inscricao_estadual": "13.123.456-7",
      "razao_social": "JOAO DA SILVA FAZENDA SANTA MARIA",
      "nome_fantasia": "FAZENDA SANTA MARIA",
      "situacao_ie": "ATIVA",
      "uf_ie": "MT",
      "tipo_ie": "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": "ATIVO",
      "data_inicio_atividade": "01/06/2015",
      "cnae_codigo": "0111-3/01",
      "cnae_descricao": "CULTIVO DE ARROZ",
      "regime_apuracao_icms": "NORMAL",
      "situacao_nfe": "HABILITADO",
      "cpf_cnpj": "123.456.789-00",
      "situacao_cadastral": "ATIVA"
    }
  ]
}

Códigos de erro

Código	HTTP Status	Descrição
`PARAMETRO_AUSENTE`	400	Parâmetro obrigatório não foi informado.
`PARAMETRO_CONFLITANTE`	400	Mais de um documento (cpf, cnpj, ie) foi enviado.
`DOCUMENTO_INVALIDO`	400	O documento informado não é válido.
`UF_NAO_SUPORTADA`	400	A UF informada não é suportada.
`PROCESSAMENTO_FALHOU`	502	Falha ao processar a consulta no estado.
`SITE_INDISPONIVEL`	503	O site da SEFAZ está indisponível no momento.
`ERRO_INTERNO`	500	Erro interno no servidor.

Esta pagina foi util?

Consultar IE por UF