FERIADOS

Feriados nacionais

Feriados nacionais fixos e móveis por ano, com a data da Páscoa calculada, não tabelada.

National holidays

Fixed and moveable national holidays by year, with a calculated (not hardcoded) Easter date.

SYNC resposta na mesma chamada answers in the same call

Endpoints

GET /api/v1/feriados/{ano} lista os feriados nacionais de um ano lists a year's national holidays

Parâmetros

Parameters

Nome	Name	Onde	In	Descrição	Description
`ano`	path	inteiro entre `1900` e `2199`	integer between `1900` and `2199`

Exemplo

Example

curl https://api.alicercelabs.com.br/api/v1/feriados/2026 \
          -H "Authorization: Bearer <token>"

{
          "success": true,
          "data": [
            { "data": "2026-01-01", "nome": "Confraternização Universal", "tipo": "fixo" },
            { "data": "2026-02-16", "nome": "Carnaval", "tipo": "movel" },
            { "data": "2026-02-17", "nome": "Carnaval", "tipo": "movel" },
            { "data": "2026-04-03", "nome": "Sexta-feira Santa", "tipo": "movel" },
            { "data": "2026-04-05", "nome": "Páscoa", "tipo": "movel" },
            { "data": "2026-04-21", "nome": "Tiradentes", "tipo": "fixo" }
          ],
          "meta": { "elapsed_ms": 0, "request_id": "..." }
        }

A resposta completa tem 14 entradas (todos os feriados fixos + os quatro móveis) — cortada aqui só pra caber no exemplo.

The full response has 14 entries (every fixed holiday plus the four moveable ones) — trimmed here just to fit the example.

Erros possíveis

Possible errors

Status	Motivo	Reason
400	ano ausente, não é um inteiro, ou está fora do intervalo 1900-2199	year missing, not an integer, or outside the 1900-2199 range
401	token ausente ou inválido	missing or invalid token
429	limite de taxa excedido	rate limit exceeded

Cálculo, não calendário fixo

Calculated, not a fixed calendar

Os feriados fixos vêm de uma tabela definida por lei federal. Os móveis (Carnaval, Sexta-feira Santa, Páscoa, Corpus Christi) saem do algoritmo de Gauss/Meeus pra data da Páscoa daquele ano — não é uma tabela pré-calculada com prazo de validade, é matemática determinística, funciona pra qualquer ano entre 1900 e 2199. Feriados estaduais não estão nesta versão.

Fixed holidays come from a table set by federal law. Moveable ones (Carnival, Good Friday, Easter, Corpus Christi) come from the Gauss/Meeus algorithm for that year's Easter date — not a pre-computed table with an expiration date, actual deterministic math, works for any year between 1900 and 2199. State holidays aren't in this version.

Usando o SDK

Using the SDK

SDKs oficiais: Go · Python · JavaScript.

Official SDKs: Go · Python · JavaScript.

Listar feriados de um ano

List a year's holidays

import (
	"context"
	"fmt"

	alicercelabs "github.com/alicercelabs/alicercesdk-go"
)

client := alicercelabs.New("alk_...") // ou um token JWT de login/register
ctx := context.Background()

holidays, err := client.Feriados.List(ctx, 2026)
if err != nil {
	panic(err)
}
for _, h := range holidays {
	fmt.Println(h.Data, h.Nome, h.Tipo)
}

from alicercelabs import AlicerceLabs

client = AlicerceLabs(api_key="alk_...")  # ou um token JWT de login/register

holidays = client.feriados.list(2026)
for h in holidays:
    print(h["data"], h["nome"], h["tipo"])

import { AlicerceLabs } from "alicercesdk-javascript";

const client = new AlicerceLabs("alk_..."); // ou um token JWT de login/register

const holidays = await client.feriados.list(2026);
holidays.forEach((h) => console.log(h.data, h.nome, h.tipo));

Limites

Limits

100/dia · 4/hora sem token, por IP chamador; com token (JWT de login ou API key gerada no painel), 1.000/dia · 41/hora.

100/day · 4/hour without a token, per calling IP; with one (a login JWT or an API key generated in the panel), 1,000/day · 41/hour.