Grátis
3.000 requisições por mês · 60 por minuto
- Feriados nacionais, 27 UFs e 5.571 municípios
- Todos os endpoints, inclusive dia útil
- 1 chave de API
- Sem SLA e sem suporte dedicado
A mesma base curada do hoje.me, com fonte e base legal em cada registro. Para folha, prazo de entrega, vencimento e agenda — com cobrança totalmente separada de qualquer outro projeto.
O plano Grátis emite a chave na hora. Start (R$ 29/mês) e Pro (R$ 99/mês) são pagos no Mercado Pago, com Pix ou cartão. O plano só entra depois da confirmação do pagamento — voltar a esta página não basta.
A cobertura geográfica é a mesma em todos os planos. O que muda é o volume, a velocidade e o suporte.
3.000 requisições por mês · 60 por minuto
100.000 requisições por mês · 120 por minuto
1.000.000 requisições por mês · 300 por minuto
Acima de 1 milhão de requisições, SLA contratual ou municípios sob demanda: plano sob consulta, pelo [email protected]. O pagamento mensal é no Mercado Pago (Pix ou cartão). Cada ciclo é um novo checkout; o plano entra só depois da confirmação do pagamento, não só por ter voltado a esta página. Se o pagamento não se renovar, há 3 dias de carência após o fim do período.
| Grátis | Start | Pro | |
|---|---|---|---|
| Preço | R$ 0 | R$ 29/mês | R$ 99/mês |
| Requisições por mês | 3.000 | 100.000 | 1.000.000 |
| Limite por minuto | 60 | 120 | 300 |
| Chaves ativas | 1 | 3 | 10 |
| Nacional, 27 UFs e os 5.571 municípios | sim | sim | sim |
| Cálculo de dia útil e próximo feriado | sim | sim | sim |
| Fonte e base legal no JSON | sim | sim | sim |
| Feriado municipal com nível de confirmação | sim | sim | sim |
| Calendário bancário FEBRABAN | não | não | não |
| Suporte | — | prioritário |
Base: https://hoje.me/api/v1 — autenticação por chave, inclusive no plano grátis.
Envie a chave no cabeçalho Authorization ou em X-API-Key. Prefixos hoje_live_ (produção) e hoje_test_ (sandbox). A chave completa aparece uma vez, na criação; guardamos só o hash. Não coloque a chave na URL nos planos pagos. No Grátis, o playground aceita ?api_key=.
curl "https://hoje.me/api/v1/feriados?ano=2026&uf=SP&cidade=sao-paulo" \ -H "Authorization: Bearer hoje_live_…"
ano é obrigatório (2026 ou 2027). Com uf entram os estaduais; com cidade (slug ou código IBGE de 7 dígitos), os municipais daquela cidade. Vale para os 5.571 municípios: use o código IBGE de 7 dígitos (a uf fica opcional) ou o slug do nome com a UF (ex.: uf=SP&cidade=campinas). Cada feriado municipal traz confianca: curada, lei_citada ou fonte_secundaria. O aniversário de cidades sem lei localizada sai como data_comemorativa (só com tipo=todos) e nunca tira o dia útil. O padrão de tipo é só feriado; use todos para incluir ponto facultativo. Cada item traz abrangência, base legal e fonte. Em 2027 o campo projecao vem true.
{
"ano": 2026,
"uf": "SP",
"cidade": { "slug": "sao-paulo", "nome": "São Paulo", "ibge": "3550308" },
"feriados": [
{
"data": "2026-01-25",
"nome": "Aniversário da cidade",
"tipo": "feriado",
"abrangencia": "municipal",
"base_legal": null,
"fonte": "https://www1.folha.uol.com.br/mercado/2026/01/veja-o-calendario-de-feriados-estaduais-e-municipais-em-2026.shtml"
}
]
}
Segunda a sexta, menos feriados da jurisdição pedida. Sábado e domingo nunca são dia útil. Ponto facultativo, por padrão, não tira o expediente — passe considerar_facultativos=true se quiser o calendário do serviço público. Este endpoint é civil, não é o calendário bancário da FEBRABAN.
curl "https://hoje.me/api/v1/dia-util?data=2026-11-20&uf=SP" \
-H "Authorization: Bearer hoje_live_…"
# { "data": "2026-11-20", "dia_util": false, "calendario": "civil",
# "feriados": [{ "nome": "Dia Nacional de Zumbi e da Consciência Negra",
# "abrangencia": "nacional" }] }
Dois modos: intervalo (inicio e fim, extremos inclusivos) ou deslocamento (data + dias, positivos ou negativos; a data de partida não entra na conta). Mesmos recortes de UF, cidade e facultativos. Intervalo máximo de 366 dias.
curl "https://hoje.me/api/v1/dias-uteis?data=2026-11-17&dias=5&uf=SP" \ -H "Authorization: Bearer hoje_live_…"
Devolve o próximo feriado, quantos dias faltam e se a data cai em terça ou quinta (emenda: true), para destacar ponte. Sem o parâmetro a_partir, vale o dia de hoje no fuso de Brasília. A data informada não entra na busca.
O endpoint /v1/cobertura traz a cobertura municipal (quantos municípios têm feriado, com lei citada ou só fonte secundária) e as lacunas. O /v1/municipios?uf=SP (ou ?q=campinas) lista código IBGE, slug, população do Censo 2022 e o nível de dado municipal de cada cidade. Já o /v1/me devolve plano, uso do mês e a data em que a cota zera (dia 1, 00h UTC, 21h de Brasília do dia anterior). Toda resposta autenticada traz os cabeçalhos X-Quota-Remaining e X-RateLimit-Remaining. Estouro responde 429, sem revogar a chave.
Nacionais com lei, 27 UFs e feriados municipais de 3.836 dos 5.571 municípios (92,1% da população), com fonte e nível de confirmação em cada registro.
projecao=true quando a portaria do ano ainda não foi curada.cidade=brasilia).cidade.dados_municipais.Números conferidos nas páginas oficiais em 17 de novembro de 2026. Links para você olhar a fonte.
| Serviço | O que cobre | Preço público |
|---|---|---|
| BrasilAPI | Feriados nacionais (UF opcional na documentação). Sem município, sem dia útil. | Grátis, sem chave. |
| Invertexto | Nacionais e estaduais, junto com várias outras APIs. | R$ 0 (3 mil/mês); R$ 49 (100 mil); R$ 99 (1 milhão). |
| Feriados API | 5.571 municípios, bancário FEBRABAN. Nacional, estadual e capitais de graça e ilimitados. | R$ 0; R$ 39 (5 mil req. de interior); R$ 99 (100 mil); R$ 249 (ilimitado). |
| Calendarific | API global, inclusive o Brasil, com recorte de estado/região. | US$ 0 (500/mês); US$ 12/mês ou 100/ano (10 mil); US$ 500/ano (50 mil). |
| hoje.me | Nacional, UFs, 5.571 municípios (com nível de confirmação) e cálculo civil de dia útil por cidade. | R$ 0 (3 mil); R$ 29 (100 mil); R$ 99 (1 milhão). |
Ninguém paga para saber que o Natal é 25 de dezembro. Paga para perguntar, em volume, se uma data mais cinco dias úteis cai no expediente de uma cidade, com fonte por trás. A BrasilAPI e o plano grátis da Feriados API resolvem a lista nacional. O Start existe para o cálculo de prazo e para uma cota previsível.
Por padrão, não. Carnaval e Corpus Christi são facultativos federais na portaria do MGI, e muita empresa privada abre. Quem quiser o calendário do serviço público envia considerar_facultativos=true.
Sim, os 5.571 aceitam o parâmetro cidade. 3.836 têm feriado municipal na base. Em 180 deles a lei está citada; nos demais a fonte é secundária, e o JSON diz isso em confianca. Para prazo legal, confirme com a prefeitura. Correções: [email protected].
Nesta página, no bloco do plano, informe o e-mail (e a chave, se já tiver uma) e siga para o Mercado Pago. O pagamento mensal aceita Pix e cartão. O plano só é liberado depois que o Mercado Pago confirma o pagamento; voltar do checkout não basta. Se a confirmação não aparecer na hora, use o aviso no topo desta página ou escreva para [email protected]. Volume acima do Pro, SLA ou municípios sob demanda também são por este e-mail. Cada pagamento do hoje.me é identificado à parte (referência hojeme:, título “hoje.me API”).
Não. Guardamos só o hash, então não dá para recuperar o texto original. Escreva para [email protected] com o e-mail do cadastro: a gente revoga a chave antiga e emite outra.
A API civil do hoje.me não substitui o calendário bancário da ANBIMA nem consulta jurídica. Os preços dos concorrentes e as taxas de Mercado Pago e Asaas foram lidos nas páginas públicas em 17 de novembro de 2026, horário de Maceió (America/Maceio), e podem ter mudado. Em caso de correção nos feriados, escreva para [email protected].