---
title: "Public holidays for a market"
description: "Public holidays in one Wego market over a date range, for spotting long weekends before searching flights."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.wego.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Public holidays for a market

`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

```bash
curl -s -H "Authorization: Bearer $TOKEN" \
  "https://api.wego.com/v1/countries/$COUNTRY_CODE/holidays"
```

Source: https://docs.wego.com/api/countries/get-country-holidays/index.mdx