---
title: Public Holidays by Country and Stock Market API
slug: public-holidays-country-stock-market
url: https://apyhub.com/callable-labs/service/public-holidays-country-stock-market
provider: Callable Labs
tags: [public-holidays, holidays, calendar, date-check, bank-holidays]
auth: api_key
version: v1
service_type: sync
endpoints: 3
atoms: 5
mcp: true
---

# Public Holidays by Country and Stock Market API

Get public holidays by country and year, find upcoming holidays, or check whether a date is a holiday, a weekend day or a business day.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/callable-labs/public-holidays-country-stock-market/v1/holidays/:year/:country` | What it does Returns every holiday of a country in a given year, sorted by date. Each holiday has i… | 5 |
| GET | `https://api.eu.apyhub.com/callable-labs/public-holidays-country-stock-market/v1/holidays/upcoming` | What it does Returns the next holidays strictly after a date, looking up to three years ahead. Choo… | 5 |
| GET | `https://api.eu.apyhub.com/callable-labs/public-holidays-country-stock-market/v1/holidays/check` | What it does Tells you whether a date is a holiday, a weekend day and a business day in one calenda… | 5 |

## Endpoint reference

### List Holidays by Country and Year

`GET https://api.eu.apyhub.com/callable-labs/public-holidays-country-stock-market/v1/holidays/:year/:country` · 5 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `year` | path | integer | yes | Year to list, from 1900 to 2100. Default: `2026`. Example: `2026`. |
| `country` | path | string | yes | ISO 3166-1 alpha-2 or alpha-3 country code, such as `US` or `DEU`. Default: `US`. Example: `US`. |
| `language` | query | string | no | Language for the holiday `name`, such as `en_US`, `de` or `fr`. Default: English when available. Example: `de`. |
| `observed` | query | boolean | no | Include days off moved by observance rules, such as a Sunday holiday observed on Monday. Default: `true`. Default: `true`. |
| `categories` | query | string | no | Comma-separated holiday categories, such as `public,bank`. Default: the calendar's main category, usually `public`. Example: `public,bank`. |
| `subdivision` | query | string | no | State, province or region code or name, such as `CA`, `BY` or `Bayern`. Omit for national holidays only. Example: `CA`. |

#### Quickstart

List the public holidays of the United States in 2026.

```bash
curl -X GET "https://api.eu.apyhub.com/callable-labs/public-holidays-country-stock-market/v1/holidays/:year/:country" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with the `year`, the `count` of holidays and a `holidays` array sorted by date. Each holiday has its `date`, `weekday`, `name`, `local_name`, `categories` and an `observed` flag that is true when an observance rule moved the day off. Only the first holidays are shown here.

```json
{
  "year": 2026,
  "count": 11,
  "country": "US",
  "subdivision": null,
  "categories": ["public"],
  "language": "en",
  "calendar_version": "2026.10",
  "holidays": [
    {
      "date": "2026-01-01",
      "weekday": "thursday",
      "name": "New Year's Day",
      "local_name": "New Year's Day",
      "categories": ["public"],
      "observed": false
    },
    {
      "date": "2026-01-19",
      "weekday": "monday",
      "name": "Martin Luther King Jr. Day",
      "local_name": "Martin Luther King Jr. Day",
      "categories": ["public"],
      "observed": false
    }
  ]
}
```

### Find Upcoming Holidays

`GET https://api.eu.apyhub.com/callable-labs/public-holidays-country-stock-market/v1/holidays/upcoming` · 5 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `after` | query | string (date) | no | Return holidays strictly after this date (`YYYY-MM-DD`). Default: today (UTC). Example: `2026-10-21`. |
| `count` | query | integer | no | How many holidays to return, from 1 to 50. Looks up to three years ahead. Default: `5`. Default: `5`. |
| `language` | query | string | no | Language for the holiday `name`, such as `en_US`, `de` or `fr`. Default: English when available. Example: `de`. |
| `observed` | query | boolean | no | Include days off moved by observance rules, such as a Sunday holiday observed on Monday. Default: `true`. Default: `true`. |
| `categories` | query | string | no | Comma-separated holiday categories, such as `public,bank`. Default: the calendar's main category, usually `public`. Example: `public,bank`. |
| `subdivision` | query | string | no | State, province or region code or name, such as `CA`, `BY` or `Bayern`. Country calendars only. Example: `CA`. |

#### Quickstart

Get the next 3 public holidays in the United States.

```bash
curl -X GET "https://api.eu.apyhub.com/callable-labs/public-holidays-country-stock-market/v1/holidays/upcoming?country=US&count=3" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with the `after` date the search started from, the `count` of holidays and a `holidays` array in date order. Each holiday has its `date`, `weekday`, `name`, `local_name`, `categories` and `observed` flag. Dates default to today in UTC.

```json
{
  "after": "2026-10-15",
  "count": 3,
  "country": "US",
  "market": null,
  "categories": ["public"],
  "language": "en",
  "calendar_version": "2026.10",
  "holidays": [
    {
      "date": "2026-11-11",
      "weekday": "wednesday",
      "name": "Veterans Day",
      "local_name": "Veterans Day",
      "categories": ["public"],
      "observed": false
    },
    {
      "date": "2026-11-26",
      "weekday": "thursday",
      "name": "Thanksgiving Day",
      "local_name": "Thanksgiving Day",
      "categories": ["public"],
      "observed": false
    },
    {
      "date": "2026-12-25",
      "weekday": "friday",
      "name": "Christmas Day",
      "local_name": "Christmas Day",
      "categories": ["public"],
      "observed": false
    }
  ]
}
```

### Check If a Date Is a Holiday or Business Day

`GET https://api.eu.apyhub.com/callable-labs/public-holidays-country-stock-market/v1/holidays/check` · 5 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `date` | query | string (date) | no | ISO date; default today (UTC) Default: `2026-12-25`. Example: `2026-12-25`. |
| `market` | query | string | no | Exchange MIC or acronym, e.g. `XNYS` or `NYSE`. Give `country` or `market`. |
| `country` | query | string | no | ISO 3166-1 alpha-2 or alpha-3 code, e.g. `US` or `DEU`. Give `country` or `market`. Default: `US`. |
| `weekend` | query | string | no | Override the weekend: weekday names or abbreviations such as `sat,sun` or `fri,sat`, or `none`. Default: the calendar's own. |
| `language` | query | string | no | Language for `name`, e.g. `en_US`, `de`, `fr`. Default: English when available. |
| `categories` | query | string | no | Comma-separated holiday categories, e.g. `public,bank`. Default: the calendar's main category (usually `public`). |
| `subdivision` | query | string | no | Subdivision code or name, e.g. `CA`, `BY` or `Bayern` (names as the calendar knows them) |

#### Quickstart

Check whether 25 December 2026 is a holiday, a weekend day or a business day in the United States.

```bash
curl -X GET "https://api.eu.apyhub.com/callable-labs/public-holidays-country-stock-market/v1/holidays/check?date=2026-12-25&country=US" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with the `date`, its `weekday`, and three booleans: `is_holiday`, `is_weekend` and `is_business_day`. `holidays` lists the holidays that fall on that date.

```json
{
  "date": "2026-12-25",
  "weekday": "friday",
  "is_holiday": true,
  "is_weekend": false,
  "is_business_day": false,
  "country": "US",
  "market": null,
  "subdivision": null,
  "categories": ["public"],
  "language": "en",
  "calendar_version": "2026.10",
  "holidays": [
    {
      "date": "2026-12-25",
      "weekday": "friday",
      "name": "Christmas Day",
      "local_name": "Christmas Day",
      "categories": ["public"],
      "observed": false
    }
  ]
}
```

## About

## What it does
Public Holidays returns the holidays of any supported country or exchange calendar. Get every holiday of a year, find the next holidays after a date, or check whether a single date is a holiday, a weekend day or a business day.

Each holiday has its date, weekday, name in English (or the `language` you ask for), the local name, its categories and whether an observance rule moved it. Add `subdivision` for state, province or region holidays, and `categories` for bank, government, optional or religious days. Official weekend workdays, such as China's swapped working days, count as business days.

`GET /v1/holidays/:year/:country` lists a year, `GET /v1/holidays/upcoming` returns the next 1 to 50 holidays within three years, and `GET /v1/holidays/check` answers for one date. Dates use `YYYY-MM-DD` and default to today in UTC.

Use it for calendar and scheduling apps, HR and payroll tools, delivery estimates, and any feature that needs to know when people are off work.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/callable-labs/service/public-holidays-country-stock-market