---
title: Public Holidays API
slug: mono-go-public-holidays
url: https://apyhub.com/apyhub/service/mono-go-public-holidays
provider: ApyHub
categories: [HR, Standard Data, Travel]
tags: [public-holidays, holiday-calendar, country-data, business-days, reference-data]
auth: api_key
---

# Public Holidays API

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

## Endpoints

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

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

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