v1

latestOpenAPI 3.1.02026-07-242735131.1 MB

Countries

List all holidays of a country

List all holidays of a country for a specific year. Optionally, it can be filtered by country subdivision.

Scopes

Category	Read only Scope	Write only Scope (read access implicit)
Manage company resources (company_admin)	View countries (country:read)	-

get/v1/countries/{country_code}/holidays/{year}

Path parameters

country_codestring required

Country code according to ISO 3166-1 3-digit alphabetic codes

yearstring required

Year for the holidays

Query parameters

country_subdivision_codestring

Country subdivision code according to ISO 3166-2 codes

Headers

Authorizationstring required

Requires a Company-scoped access token obtained through the Authorization Code flow or the Refresh Token flow.

The refresh token needs to have been obtained through the Authorization Code flow.

Response

Success

Example response

{
  "data": [
    {
      "day": "2021-01-01",
      "name": "New Year's Day",
      "note": "The day after New Year's Eve",
      "observed_day": "2021-01-02"
    }
  ]
}