---
title: "Public holidays for a market"
method: GET
path: "/v1/countries/{countryCode}/holidays"
tags: ["Countries"]
---

# 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.

## Path parameters

- `countryCode` string, required

## Query parameters

- `fromDate` string
- `toDate` string
- `locale` string

## Response `200`

Holidays in the searched range, plus that range.

- object
  - `results` object[], required — Public holidays in the resolved window.
    - `name` string, required — Localized holiday name.
    - `key` string, required — Stable upstream slug (e.g. national_day) – the same holiday carries the same key across locales.
    - `startDate` string, required — Inclusive ISO YYYY-MM-DD start.
    - `endDate` string, required — Inclusive ISO YYYY-MM-DD end; equals startDate for one-day holidays.
  - `metadata` object, required — The market, the resolved date window, and the result count for this read.
    - `resultCount` integer, required — Number of holidays returned.
    - `countryCode` string, required — The market the holidays are for.
    - `window` 'explicit' | 'upcoming', required — `explicit` when the caller supplied both dates, `upcoming` when the API chose the range (stated in from/to).
    - `from` string, required — Inclusive ISO start of the range actually searched.
    - `to` string, required — Inclusive ISO end of the range actually searched.

## Other responses

- `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.

---

[API](https://skmtc.net/wego/apis/wego-api.md) · [All operations](https://skmtc.net/wego/apis/wego-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wego/wego-api/revisions/e5d7af502419/schema)