API de Feriados Estaduais por UF
Consulte os feriados estaduais de qualquer UF do Brasil em JSON. Cobertura das 27 unidades federativas, gratuita em todos os planos.
A API de feriados estaduais retorna, em JSON, os feriados de cada uma das 27 unidades federativas do Brasil (os 26 estados mais o Distrito Federal). Basta informar a sigla da UF, como SP, RJ ou MG, e o endpoint devolve nome, data e tipo de cada feriado. A consulta por estado é gratuita em todos os planos.
Como usar
Faça uma requisição GET para o endpoint de feriados estaduais informando a sigla da UF. A resposta vem em JSON.
# Feriados nacionais e estaduais do estado de São Paulo (gratuito)
curl https://feriadosapi.com/api/v1/feriados/estado/SP?ano=2026 \
-H "X-API-Key: SUA_CHAVE"
# Resposta
{
"uf": "SP",
"ano": "2026",
"feriados": [
{ "nome": "Confraternização Universal", "data": "01/01/2026", "tipo": "NACIONAL" },
{ "nome": "Revolução Constitucionalista", "data": "09/07/2026", "tipo": "ESTADUAL" }
]
}Autenticação via header X-API-Key ou Authorization: Bearer SUA_CHAVE. Toda resposta inclui o header X-Quota-Remaining.
Páginas por estado
Veja os feriados de cada estado com calendário e detalhes. Alguns exemplos:
Feriados estaduais da UF de SP.
Feriados do Rio de JaneiroFeriados estaduais da UF do RJ.
Feriados de Minas GeraisFeriados estaduais da UF de MG.
Veja todos os feriados do ano no calendário de feriados.
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 consulto os feriados de um estado específico?
Faça uma requisição GET para /api/v1/feriados/estado/{uf}, usando a sigla da UF, por exemplo SP, RJ ou MG. A resposta vem em JSON com nome, data e tipo de cada feriado.
Os feriados nacionais aparecem junto com os estaduais?
Sim. O endpoint de feriados estaduais retorna os feriados nacionais e os estaduais da UF juntos, já que ambos valem no estado. Você recebe o calendário aplicável à UF em uma única chamada.
Como faço autenticação na API?
Use sua chave de API no header X-API-Key ou em Authorization: Bearer SUA_CHAVE. Toda resposta inclui o header X-Quota-Remaining com a cota restante.