---
title: "Official bank holidays"
method: GET
path: "/rest/api/v1/projects/{projectId}/bankHolidays"
tags: ["News API"]
---

# Official bank holidays

`GET /rest/api/v1/projects/{projectId}/bankHolidays`

## Request

- Base URL: `https://api.metacopier.io`
- URL: `https://api.metacopier.io/rest/api/v1/projects/{projectId}/bankHolidays`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/metacopier/apis/metacopier-api/docs/rest/api/v1/projects/:projectId/bankHolidays/get.ts> (a function with typed inputs; its response is checked against the schema)

Imported weekly from Nager.Date. The trading filter itself runs off the calendar's own holiday rows, this is the official second source that makes a missing holiday visible. Defaults to the next 30 days.

## Path parameters

- `projectId` string, uuid, required

## Query parameters

- `from` string
- `to` string
- `countries` string

## Response `200`

OK

- BankHolidayDTO[]
  - `countryCode` string: ISO-3166 alpha-2 country code
  - `currencyCode` string: Currency the country trades in
  - `date` string: Date of the holiday (ISO-8601, no time)
  - `global` boolean: True when the holiday applies to the whole country
  - `id` string: Composite id of country and date
  - `localName` string: Name in the local language
  - `name` string: English name
  - `types` string[]: Nager types, for example Public or Bank

## Changes

- **2026-08-30** `69d2d39c695e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/metacopier/apis/metacopier-api/changes/rest/api/v1/projects/:projectId/bankHolidays/get.md)

---

[API](https://skmtc.dev/metacopier/apis/metacopier-api.md) - [All operations](https://skmtc.dev/metacopier/apis/metacopier-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metacopier/apis/metacopier-api/revisions/cbf3e7810fc2?raw)