API de Inscrição Estadual nas 27 UFs em uma chamada

Consulta a Inscrição Estadual (IE) de um contribuinte em todos os 27 estados simultaneamente.

GET /api/consultar-ie-todos

Consulta a Inscrição Estadual de um contribuinte em todos os 27 estados simultaneamente a partir de CPF ou CNPJ. A API retorna os resultados agrupados por UF, incluindo o status individual de cada estado.

Autenticação

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

Parâmetros de consulta

O parâmetro ie não é suportado nesta rota. Uma Inscrição Estadual é vinculada a um único estado, portanto não faz sentido consultar em todos. Use o endpoint Consultar IE por UF para consultas por IE.

Name	Type	Required	Description
`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).

Você deve informar exatamente um dos parâmetros cpf ou cnpj.

Exemplos de código

Consulta por CPF

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

const response = await fetch(
  "https://api.fiscalapi.com.br/api/consultar-ie-todos?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-ie-todos",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"cpf": "12345678900"},
)
data = response.json()
for estado in data["results"]:
    print(f"{estado['uf']}: {len(estado['results'])} IE(s)")

$response = Http::withHeaders([
    'X-API-Key' => 'fapi_sua_chave_aqui',
])->get('https://api.fiscalapi.com.br/api/consultar-ie-todos', [
    '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-ie-todos?cpf=12345678900"
);
var data = await response.Content.ReadAsStringAsync();

Consulta por CNPJ

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

const response = await fetch(
  "https://api.fiscalapi.com.br/api/consultar-ie-todos?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-ie-todos",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"cnpj": "12345678000199"},
)
data = response.json()
for estado in data["results"]:
    print(f"{estado['uf']}: {len(estado['results'])} IE(s)")

$response = Http::withHeaders([
    'X-API-Key' => 'fapi_sua_chave_aqui',
])->get('https://api.fiscalapi.com.br/api/consultar-ie-todos', [
    '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-ie-todos?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` ou `cnpj`.
`cached_ufs`	array	Lista de UFs cujo resultado veio do cache.
`results`	array	Lista de resultados por estado.

Campos de cada estado (`results[]`)

Campo	Tipo	Descrição
`uf`	string	Sigla do estado.
`source_status`	object	Status da consulta neste estado.
`source_status.status`	string	`success`, `error` ou `timeout`.
`source_status.error_code`	string	Código de erro (vazio se sucesso).
`source_status.error_message`	string	Mensagem de erro (vazio se sucesso).
`results`	array	Lista de inscrições estaduais encontradas neste estado. Array vazio se nenhuma IE encontrada.

Cada item dentro de results[].results[] contém os mesmos campos documentados em Consultar IE por UF.

Exemplo de resposta

{
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "document": "12345678900",
  "document_type": "cpf",
  "cached_ufs": [],
  "results": [
    {
      "uf": "MT",
      "source_status": {
        "status": "success",
        "error_code": "",
        "error_message": ""
      },
      "results": [
        {
          "inscricao_estadual": "13.123.456-7",
          "razao_social": "JOAO DA SILVA FAZENDA SANTA MARIA",
          "situacao_ie": "ATIVA",
          "uf_ie": "MT"
        }
      ]
    },
    {
      "uf": "SP",
      "source_status": {
        "status": "success",
        "error_code": "",
        "error_message": ""
      },
      "results": []
    }
  ]
}

Mesmo quando um estado retorna erro (ex: SEFAZ indisponível), os demais estados continuam sendo consultados normalmente. Verifique o campo source_status de cada UF para tratar falhas individuais.

Códigos de erro

Código	HTTP Status	Descrição
`PARAMETRO_AUSENTE`	400	Nenhum documento (cpf ou cnpj) foi informado.
`IE_NAO_SUPORTADO`	400	O parâmetro `ie` foi enviado, mas não é suportado nesta rota.
`ERRO_INTERNO`	500	Erro interno no servidor.

Esta pagina foi util?

Consultar IE em Todos os Estados