FiscalAPI: primeira chamada à API em 5 minutos

Siga estes passos para fazer sua primeira consulta na FiscalAPI.

1. Crie sua conta

Acesse app.fiscalapi.com.br e registre-se.

Opção A: Consulte pelo Dashboard (sem código)

Após criar sua conta, acesse Consultas no menu lateral. Preencha o tipo de documento (CPF, CNPJ ou IE), o número do documento e o estado. Clique em Consultar e veja o resultado na tela.

Não precisa de API Key, código ou qualquer integração. Todos os tipos de consulta estão disponíveis: IE, CNPJ, CND e SIGEF.

Opção B: Integre via API

Para automatizar consultas no seu sistema, gere sua API Key em Chave API no dashboard.

2. Faça sua primeira consulta

Consulte a Inscrição Estadual de um contribuinte por CPF, CNPJ ou IE. Veja um exemplo com CPF no Mato Grosso:

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();

Para consultar por CNPJ, basta substituir o parâmetro cpf por cnpj:

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

3. Entenda a 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",
      "situacao_ie": "ATIVA",
      "uf_ie": "MT",
      "tipo_ie": "PRODUTOR RURAL",
      "municipio": "RONDONOPOLIS"
    }
  ]
}

Próximos passos

Consulta IE — Todos os parâmetros e campos de resposta
Consulta CNPJ — Dados da Receita Federal
Tratamento de Erros — Códigos de erro e como lidar

Esta pagina foi util?

Quickstart