List holiday countries

GET

/holidays/countries

Last modified:2026-09-28 00:01:27

OperationId:ReadListSupportedCountries

Returns the countries the holiday lookup covers, with their ISO 3166-1 alpha-2 code in iso-3166. Use that code as {country} in GET /holidays/{country}/{year}. Any authenticated token can call it: holiday data is not scoped to a domain, and no scope privilege is checked.

Holidays come from the platform's holiday lookup service, a hosted Calendarific proxy the API calls over HTTPS with a 3-second connect and 8-second total limit. Answers are cached for 24 hours per country, region, year, and language; failures are not cached. If the service fails, times out, or answers anything but a holiday list, the call returns 503; retry later. The fields are passed through from the service as it sends them.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

The supported countries.

Bodyapplication/json

🟠401Authentication Required

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://awqacore01.crexendocloud.com/ns-api/v2/holidays/countries' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "country_name": "Afghanistan",
    "iso-3166": "AF",
    "total_holidays": 24,
    "supported_languages": 2,
    "uuid": "f0357a3f154bc2ffe2bff55055457068",
    "flag_unicode": "🇦🇫"
}

Modified at 2026-09-28 00:01:27

List user time frame names

List holiday regions