Status das SEFAZs

Consulte o status em tempo real de todas as SEFAZs estaduais para NFe, NFCe e CTe.

GET /api/v1/sefaz/status

Retorna o status atual de todas as SEFAZs estaduais brasileiras em tempo real. Os dados são atualizados a cada 2 minutos a partir do monitoramento da TecnoSpeed.

Útil para verificar se uma SEFAZ está operando normalmente antes de enviar documentos fiscais, ou para exibir um painel de status no seu sistema.

Autenticação

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

Parâmetros de consulta

Name	Type	Required	Default	Description
`doc`	string	Não	`nfe`	Tipo de documento fiscal: `nfe`, `nfce` ou `cte`.

Exemplos de código

curl -X GET "https://api.fiscalapi.com.br/api/v1/sefaz/status?doc=nfe" \
  -H "X-API-Key: fapi_sua_chave_aqui"

const response = await fetch(
  "https://api.fiscalapi.com.br/api/v1/sefaz/status?doc=nfe",
  { headers: { "X-API-Key": "fapi_sua_chave_aqui" } }
);
const data = await response.json();

// Filtrar estados com problema
const problemas = data.states.filter(s => s.status_code > 1);
console.log(`${problemas.length} estados com problema`);

import requests

response = requests.get(
    "https://api.fiscalapi.com.br/api/v1/sefaz/status",
    headers={"X-API-Key": "fapi_sua_chave_aqui"},
    params={"doc": "nfe"},
)
data = response.json()

# Filtrar estados com problema
problemas = [s for s in data["states"] if s["status_code"] > 1]
print(f"{len(problemas)} estados com problema")

$response = Http::withHeaders([
    'X-API-Key' => 'fapi_sua_chave_aqui',
])->get('https://api.fiscalapi.com.br/api/v1/sefaz/status', [
    'doc' => 'nfe',
]);
$data = $response->json();

// Filtrar estados com problema
$problemas = array_filter($data['states'], fn($s) => $s['status_code'] > 1);

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/v1/sefaz/status?doc=nfe"
);
var json = await response.Content.ReadAsStringAsync();

Resposta

Campos de nível superior

Campo	Tipo	Descrição
`doc`	string	Tipo de documento consultado: `nfe`, `nfce` ou `cte`.
`timestamp`	string	Data/hora da última atualização em formato ISO 8601 (UTC).
`states`	array	Lista com o status de cada estado (27 itens).

Campos de cada estado (`states[]`)

Campo	Tipo	Descrição
`uf`	string	Sigla do estado (ex: `SP`, `MT`, `RJ`).
`status_code`	integer	Código numérico do status (0 a 5).
`status`	string	Descrição legível do status.
`status_avg`	number	Média do tempo de resposta usado para classificação.

Códigos de status

Código	Status	Descrição
`0`	Indisponível	Sem leitura para esta UF no momento da coleta. Estado transitório, costuma normalizar no ciclo seguinte.
`1`	Normal	Tempo de resposta menor que 2 segundos.
`2`	Lento	Tempo de resposta entre 2 e 6 segundos.
`3`	Muito lento	Tempo de resposta entre 6 e 30 segundos.
`4`	Erro	SEFAZ retornando erro.
`5`	Timeout	SEFAZ não respondeu dentro do tempo limite.

Exemplo de resposta

{
  "doc": "nfe",
  "timestamp": "2026-04-06T15:30:00.000000+00:00",
  "states": [
    {
      "uf": "AC",
      "status_code": 2,
      "status": "Lento",
      "status_avg": 3.2451
    },
    {
      "uf": "AL",
      "status_code": 1,
      "status": "Normal",
      "status_avg": 0.8712
    },
    {
      "uf": "AM",
      "status_code": 1,
      "status": "Normal",
      "status_avg": 1.1234
    },
    {
      "uf": "SP",
      "status_code": 1,
      "status": "Normal",
      "status_avg": 0.4521
    }
  ]
}

A resposta sempre inclui as 27 UFs brasileiras (26 estados + DF), ordenadas alfabeticamente pela sigla. Quando não há leitura disponível para uma UF no momento da coleta, ela vem com status_code: 0 (Indisponível) em vez de ser omitida — assim você nunca perde uma UF do payload.

Casos de uso

Painel de status: Exiba um dashboard com o status de cada SEFAZ para sua equipe fiscal.
Verificação pré-envio: Antes de transmitir um lote de NF-e, verifique se a SEFAZ do estado está operando normalmente.
Alertas automáticos: Configure alertas quando um estado muda de Normal para Lento, Erro ou Timeout.
Decisão de contingência: Use o status para decidir automaticamente quando ativar o modo de contingência (SVC-AN/SVC-RS).

Códigos de erro

Código	HTTP Status	Descrição
`MONITOR_INDISPONIVEL`	502	Não foi possível consultar o status das SEFAZs no momento.
`PARAMETRO_INVALIDO`	400	O parâmetro `doc` deve ser `nfe`, `nfce` ou `cte`.

Esta pagina foi util?

Status das SEFAZs

On this page