Projeto open source

Feriados do Brasil,
no seu controle.

Uma API open source para consultar feriados nacionais, estaduais e municipais.

Rode na sua infraestrutura. Use, adapte e contribua com o código e os dados.

terminal · feriados.dev

# Inicie com Docker Compose
docker compose up --build

# Consulte a API local
curl "http://localhost:3000/v1/holidays/year/2026"

{
  "status": "success",
  "data": [
    {
      "name": "Confraternização Universal",
      "date": "2026-01-01",
      "type": "national"
    }
  ]
}

01 O projeto

Uma base brasileira. Na sua infraestrutura.

Consulte feriados nacionais, estaduais e municipais com uma API que pode ser instalada, modificada e operada por você. Sem cadastro, sem API key e sem limites comerciais.

Dados organizados por localidade

As datas nacionais, estaduais e municipais seguem a hierarquia de cada lugar.

Você opera e adapta

PostgreSQL, Node.js e Docker Compose. O código fica no seu ambiente.

Aberto para contribuição

MIT, dados versionados em SQL e um fluxo claro para revisar mudanças.

02 Comece aqui

Seu próximo calendário começa no terminal.

Clone o repositório e suba a API e o banco localmente com Docker Compose.

Ver instruções e requisitos

terminal shell

# Obtenha o código
git clone https://github.com/feriados-dev/feriados-dev-oss.git
cd feriados-dev-oss

# Inicie a API e o PostgreSQL
cp .env.example .env
docker compose up --build

Primeira consulta GET /v1/holidays/year/2026

Contrato OpenAPI

03 Código aberto

Use. Adapte. Compartilhe.

O projeto é mantido publicamente no GitHub e distribuído sob a licença MIT.

Acessar repositório

Feriados do Brasil,no seu controle.