---
title: Public Holidays API
slug: public-holidays
url: https://apyhub.com/apyhub/service/public-holidays
provider: ApyHub
categories: [HR, Standard Data, Travel]
tags: [public-holidays, holiday-calendar, country-data, business-days, reference-data]
auth: api_key
version: 1.0
service_type: sync
endpoints: 2
atoms: 10
mcp: true
---

# Public Holidays API

Get public holidays by country and year, plus the supported country list. Built for business-day logic, scheduling, and holiday calendars.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/apyhub/public-holidays/holidays` | What it does Returns the public holidays for a specified country, optionally filtered by year. Quer… | 10 |
| GET | `https://api.eu.apyhub.com/apyhub/public-holidays` | What it does Returns a JSON object containing a data array of strings listing the countries support… | 10 |

## Endpoint reference

### List public holidays for a country and year

`GET https://api.eu.apyhub.com/apyhub/public-holidays/holidays` · 10 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `year` | query | integer | no | Example: `2025`. |
| `country` | query | string | yes | Example: `DE`. |

#### Quickstart

Fetch public holidays for a country, optionally filtered by year.

```bash
curl -X GET "https://api.eu.apyhub.com/apyhub/public-holidays/holidays?country=DE&year=2025" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `data` array. Each item in the array is an object with `date` and `name` fields for a holiday.

```json
{
  "data": [
    {
      "date": "2025-01-01",
      "name": "Neujahrstag"
    }
  ]
}
```

### List countries supported by the holidays endpoint

`GET https://api.eu.apyhub.com/apyhub/public-holidays` · 10 atoms · accepts `application/json` · returns `application/json`

#### Quickstart

Fetch the list of public holidays for the selected country.

```bash
curl -X GET "https://api.eu.apyhub.com/apyhub/public-holidays" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

Returns a JSON object with a `data` array of strings, where each string is a public holiday entry.

```json
{
  "data": ["New Year's Day", "Independence Day", "Christmas Day"]
}
```

## About

## What it does
Public Holidays gives you a country-by-country holiday calendar for a given year. Send a country code, optionally add a year, and get back an array of holiday dates and names in the country’s primary language.

Use it when you need to block out non-working days in scheduling logic, calculate business-day deadlines, or pre-fill region-aware calendars in your product. The holiday list response includes `date` in `YYYY-MM-DD` format and `name` for each holiday, so you can display or store the results directly.

The service also lets you list the countries it supports. That makes it easy to build country selectors, validate user input before a holiday lookup, or sync supported markets into your internal configuration.

Public Holidays is a small reference-data API: simple inputs, predictable output, and no extra fields to parse. Keep your date logic aligned with local holiday schedules instead of hard-coding them.

## 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/apyhub/service/public-holidays