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_...")
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_...")

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_...");

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 uma API key (gerada no painel), 1.000/dia · 41/hora.

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