Holidays
The holidays endpoints return resolved feriados — fixed dates, movable dates already computed (Páscoa, Carnaval, Corpus Christi…), national + state + municipal scopes.
List holidays
OpenAPI operation
GET /v1/holidays not found in the current snapshot. Run npm run openapi:dump in apps/web after starting the API.scope accepts NATIONAL, STATE, MUNICIPAL. Combine with uf and/or ibge to narrow further. When ibge is provided, the response merges national + state(UF) + municipal scopes for that city.
Check a single date
OpenAPI operation
GET /v1/holidays/check not found in the current snapshot. Run npm run openapi:dump in apps/web after starting the API.Returns { "isHoliday": true, "matches": [...] } so you can branch on the answer in one round-trip.