Finnish Holiday calendar API

API demo

Finnish calendar

GET /api/calendar

Parameters

start Start date in form YYYY-mm-dd. Optional, default today.
end End date in form YYYY-mm-dd. Optional, default start date.
full_month Expand to full month, true/false. Optional, default false.

Result

List working days between start and end in YYYY-mm-dd format, values are in format

working_day: boolean
desc: working day, weekend or text describing holiday

{
    "2025-08-10": "working day",
    "2025-08-11": "weekend"
}

Finnish working days

GET /api/working-days

Parameters

start Start date in form YYYY-mm-dd. Optional, default today.
end End date in form YYYY-mm-dd. Optional, default start date.
full_month Expand to full month, true/false. Optional, default false.

Result

List working days between start and end in YYYY-mm-dd format, values are in format

working_day: boolean
desc: working day, weekend or text describing holiday

{
    "2025-08-10": "working day"
}

Finnish non-working days

GET /api/non-working-days

Parameters

start Start date in form YYYY-mm-dd. Optional, default today.
end End date in form YYYY-mm-dd. Optional, default start date.
full_month Expand to full month, true/false. Optional, default false.

Result

List working days between start and end in YYYY-mm-dd format, values are in format

working_day: boolean
desc: working day, weekend or text describing holiday

{
    "2025-08-11": "weekend"
}

Considerations

Currently API is rate limited to 2 requests per second

Get current day

`GET https://holiday-calendar.fi/api/calendar`

Get current month

`GET https://holiday-calendar.fi/api/calendar?full_month=true`

Get date range

`GET https://holiday-calendar.fi/api/calendar?start=01-01-2022&end=31-03-2022`

Get holidays in range

`GET https://holiday-calendar.fi/api/non-working-days?start=01-01-2022&end=31-03-2022`