GET /v1/countries/{countryCode}/holidays
Public holidays in one Wego market over a date range, for spotting long weekends before searching flights. Give both fromDate and toDate, or neither – omit both and the API searches the next 90 days and says so in metadata.window/from/to.
Operation ID: getCountryHolidays
Parameters
| Name | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
countryCode |
path | string | yes | pattern ^[A-Z]{2}$ |
ISO 3166-1 alpha-2 code of the Wego market whose public holidays you want (e.g. AE). A destination MARKET, not a passport: it must be one of Wego’s markets, and an unknown one is rejected 400. The same path segment means a passport on the visa-free route. |
fromDate |
query | string | no | pattern ^\d{4}-\d{2}-\d{2}$ |
Inclusive ISO start date. Give both fromDate and toDate, or neither. |
toDate |
query | string | no | pattern ^\d{4}-\d{2}-\d{2}$ |
Inclusive ISO end date. Give both fromDate and toDate, or neither. |
locale |
query | string | no | length 1..35; default "en" |
Locale for localized names (e.g. en, ar). Defaults to en. |
Responses
| Status | Description |
|---|---|
200 |
Holidays in the searched range, plus that range. |
400 |
Unknown market, malformed date, only one of fromDate/toDate, or fromDate after toDate. |
401 |
Missing or invalid bearer token. |
429 |
Rate limit exceeded; retry after the Retry-After seconds. |
502 |
The upstream holidays service returned an invalid response. |
503 |
The holidays service is temporarily unavailable; retry after the Retry-After seconds. |
200 body
| Field | Type | Always present | Description |
|---|---|---|---|
results |
object[] | yes | Public holidays in the resolved window. |
↳ name |
string | yes | Localized holiday name. |
↳ key |
string | yes | Stable upstream slug (e.g. national_day) – the same holiday carries the same key across locales. |
↳ startDate |
string | yes | Inclusive ISO YYYY-MM-DD start. |
↳ endDate |
string | yes | Inclusive ISO YYYY-MM-DD end; equals startDate for one-day holidays. |
metadata |
object | yes | The market, the resolved date window, and the result count for this read. |
↳ resultCount |
integer | yes | Number of holidays returned. |
↳ countryCode |
string | yes | The market the holidays are for. |
↳ window |
explicit | upcoming |
yes | explicit when the caller supplied both dates, upcoming when the API chose the range (stated in from/to). |
↳ from |
string | yes | Inclusive ISO start of the range actually searched. |
↳ to |
string | yes | Inclusive ISO end of the range actually searched. |
Example
curl -s -H "Authorization: Bearer $TOKEN" \
"https://api.wego.com/v1/countries/$COUNTRY_CODE/holidays"