Skip to main content
GET
/
core
/
v1
/
holidays
List Holidays
curl --request GET \
  --url https://api.engrate.io/core/v1/holidays \
  --header 'Authorization: <api-key>'
{
  "holidays": [
    {
      "date": "2026-12-25",
      "holiday": "se/juldagen",
      "timezone": "Europe/Stockholm"
    }
  ]
}

​
Holiday identifiers

ValueDescription
no/forste_nyttarsdagJanuary 1st.
no/skjartorsdagThe Thursday before Easter Sunday (moveable).
no/langfredagThe Friday before Easter Sunday (moveable).
no/forste_paskedagEaster Sunday (moveable).
no/andre_paskedagThe Monday after Easter Sunday (moveable).
no/arbeidernes_dagMay 1st.
no/kristi_himmelfartsdagAscension Day, the Thursday 39 days after Easter (moveable).
no/grunnlovsdagMay 17th.
no/forste_pinsedagWhit Sunday / Pentecost (moveable).
no/andre_pinsedagWhit Monday (moveable).
no/forste_juledagDecember 25th.
no/andre_juledagDecember 26th.
se/nyarsdagenJanuary 1st.
se/trettondagsaftonJanuary 5th (Epiphany Eve).
se/trettondedag_julJanuary 6th (Epiphany).
se/skartorsdagenThe Thursday before Easter Sunday (moveable).
se/langfredagenThe Friday before Easter Sunday (moveable).
se/paskaftonThe Saturday before Easter Sunday — Easter Eve (moveable).
se/paskdagenEaster Sunday (moveable).
se/annandag_paskThe Monday after Easter Sunday (moveable).
se/forsta_majMay 1st.
se/kristi_himmelsfardAscension Day, the Thursday 39 days after Easter (moveable).
se/pingstaftonWhitsun Eve, the Saturday before Pentecost (moveable).
se/nationaldagenJune 6th.
se/midsommaraftonThe Friday before Midsummer Day (moveable).
se/allhelgonaaftonThe Friday between October 30th and November 5th — All Saints’ Eve.
se/julaftonDecember 24th.
se/juldagenDecember 25th.
se/annandag_julDecember 26th.
se/nyarsaftonDecember 31st.

Authorizations

​
Authorization
string
header
required

Query Parameters

​
start_year
integer
required

Start year (inclusive).

​
end_year
integer
required

End year (exclusive).

​
country
string | null

ISO 3166-1 alpha-2 country code (lowercase).

Required string length: 2
Example:

"se"

​
holiday
enum<string>[] | null

Filter to specific holiday identifiers.

Public holiday

Available options:
no/forste_nyttarsdag,
no/skjartorsdag,
no/langfredag,
no/forste_paskedag,
no/andre_paskedag,
no/arbeidernes_dag,
no/kristi_himmelfartsdag,
no/grunnlovsdag,
no/forste_pinsedag,
no/andre_pinsedag,
no/forste_juledag,
no/andre_juledag,
se/nyarsdagen,
se/trettondagsafton,
se/trettondedag_jul,
se/skartorsdagen,
se/langfredagen,
se/paskafton,
se/paskdagen,
se/annandag_pask,
se/forsta_maj,
se/kristi_himmelsfard,
se/pingstafton,
se/nationaldagen,
se/midsommarafton,
se/allhelgonaafton,
se/julafton,
se/juldagen,
se/annandag_jul,
se/nyarsafton

Response

Successful Response

Holidays in the requested range.

​
holidays
HolidayOccurrence · object[]
required