API de Feriados Estaduais por UF
Consulte os feriados estaduais das 27 unidades federativas do Brasil em JSON. Gratuito em todos os planos, por sigla do estado.
A API de feriados estaduais retorna os feriados oficiais de qualquer um dos 27 estados brasileiros (26 UFs e o Distrito Federal) em formato JSON, a partir da sigla da UF. O endpoint é gratuito em todos os planos da Feriados API e não consome cota mensal.
Como usar
Faça uma requisição GET informando a sigla da UF desejada (ex: SP, RJ, MG). A resposta lista os feriados estaduais daquele estado em formato JSON.
# Listar feriados estaduais de São Paulo (SP)
curl https://feriadosapi.com/api/v1/feriados/estado/SP?ano=2026 \
-H "X-API-Key: SUA_CHAVE"
# Resposta
[
{ "nome": "Revolução Constitucionalista", "data": "09/07/2026", "tipo": "ESTADUAL", "uf": "SP" }
]Autenticação via header X-API-Key ou Authorization: Bearer SUA_CHAVE. Toda resposta inclui o header X-Quota-Remaining.
Cobertura e benefícios
Perguntas frequentes
A API de feriados estaduais é gratuita?
Sim. O endpoint de feriados estaduais por UF é gratuito em todos os planos, incluindo o plano Free, e não consome cota mensal.
Quantos estados a API cobre?
A API cobre as 27 unidades federativas do Brasil: os 26 estados mais o Distrito Federal. Basta informar a sigla da UF no endpoint.
Como faço a consulta por estado?
Faça uma requisição GET para /api/v1/feriados/estado/{uf}, substituindo {uf} pela sigla do estado (ex: SP, RJ, BA). Você também pode passar o parâmetro ?ano=AAAA.
Qual a diferença entre feriado estadual e municipal?
O feriado estadual é instituído por lei estadual e vale para todos os municípios do estado (como a Revolução Constitucionalista em SP). Já o municipal é local de cada cidade.
Como funciona a autenticação e cota?
Use o header X-API-Key ou Authorization: Bearer. A chamada a feriados estaduais não consome cota, mas é obrigatório autenticar. O header X-Quota-Remaining indica sua cota disponível.