---
title: "GET /api/calendar/holidays"
method: GET
path: "/api/calendar/holidays"
tags: ["Market Calendar"]
---

# GET /api/calendar/holidays

`GET /api/calendar/holidays`

## Request

- Base URL: `https://api.unirateapi.com`
- URL: `https://api.unirateapi.com/api/calendar/holidays`
- Auth: none declared
- TypeScript: <https://skmtc.dev/unirateapi/apis/unirate-api/docs/api/calendar/holidays/get.ts> (a function with typed inputs; its response is checked against the schema)

Public holidays for a country (optionally a subdivision/state) or a currency's settlement calendar in a given year. Available on the FREE tier (counts against the daily request quota). Holiday names are in English where the rule set provides it. Reference only.

## Query parameters

- `api_key` string, required
- `country` string
- `subdiv` string
- `currency` string
- `year` integer
- `format` 'json' | 'xml'
- `callback` string

## Response `200`

Holidays for the year.

## Other responses

- `400`: Invalid country/subdiv/currency/year/format
- `401`: Missing or invalid API key
- `404`: Country or currency not supported
- `429`: Daily request quota exceeded

---

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