Terça-feira, 17 de novembro de 2026São Paulo · nascer 05h13 · pôr 18h31Contato
API

Feriados e dias úteis do Brasil, em JSON.

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.

Planos

A cobertura geográfica é a mesma em todos os planos. O que muda é o volume, a velocidade e o suporte.

Para testar

Grátis

R$ 0

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
Para volume alto

Pro

R$ 99 /mês

1.000.000 requisições por mês · 300 por minuto

  • Tudo do Start
  • 10 chaves ativas
  • Suporte com prioridade
  • Ambiente de teste com cota à parte

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.

O que entra em cada faixa

GrátisStartPro
PreçoR$ 0R$ 29/mêsR$ 99/mês
Requisições por mês3.000100.0001.000.000
Limite por minuto60120300
Chaves ativas1310
Nacional, 27 UFs e os 5.571 municípiossimsimsim
Cálculo de dia útil e próximo feriadosimsimsim
Fonte e base legal no JSONsimsimsim
Feriado municipal com nível de confirmaçãosimsimsim
Calendário bancário FEBRABANnãonãonão
Suporte—e-mailprioritário

Documentação da v1

Base: https://hoje.me/api/v1 — autenticação por chave, inclusive no plano grátis.

Auth

Chave de API

Authorization: Bearer hoje_live_…

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_…"
GET

Listar feriados

/v1/feriados?ano=&uf=&cidade=&tipo=

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"
    }
  ]
}
GET

É dia útil?

/v1/dia-util?data=&uf=&cidade=

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" }] }
GET

Contar ou somar dias úteis

/v1/dias-uteis?inicio=&fim= ou ?data=&dias=

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_…"
GET

Próximo feriado

/v1/proximo-feriado?a_partir=&uf=&cidade=

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.

GET

Cobertura e cota

/v1/cobertura · /v1/municipios · /v1/me

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.

Os dados de hoje

Os 5.571 municípios, com o nível de confirmação de cada feriado.

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.

  • Nacionais de 2026 com a Portaria MGI 11.460/2025; 2027 projetado pelas mesmas leis, com projecao=true quando a portaria do ano ainda não foi curada.
  • Estaduais das 27 UFs. Algumas listas de 2026 estão vazias de propósito (GO, MT, MG, PR, SC), com nota na curadoria.
  • Municipais: capitais revisadas pelo hoje.me e, nos demais municípios, bases abertas com licença MIT (joaopbini/feriados-brasil e luishw12/feriados-app). 180 municípios têm a lei municipal citada; nos outros, a fonte é secundária. Brasília entra pelo Distrito Federal (cidade=brasilia).
  • 1.438 municípios só têm o aniversário da cidade (Wikipédia), sem lei localizada, e 297 ainda não têm nenhum dado municipal. Nesses, a API responde com nacionais e estaduais e avisa em cidade.dados_municipais.
  • Calendário bancário da ANBIMA/FEBRABAN fica de fora desta versão.

Como o preço se compara

Números conferidos nas páginas oficiais em 17 de novembro de 2026. Links para você olhar a fonte.

ServiçoO que cobrePreç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).

Perguntas frequentes

Por que alguém pagaria, se já existe API grátis?

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.

Ponto facultativo conta como dia não útil?

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.

Vocês cobrem todos os municípios?

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].

Como assino o Start ou o Pro?

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”).

Perdi a minha chave. Vocês reenviam?

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].