---
title: "Fetch public holidays for a country and date range"
method: GET
path: "/holidays"
---

# Fetch public holidays for a country and date range

`GET /holidays`

## Request

- Base URL: `https://api.gadgethumans.com`
- URL: `https://api.gadgethumans.com/holidays`
- Auth: none declared

Public holidays - List public holidays for a country (?country=IE) and optional ?date= - for scheduling, payroll and delivery planning.

## Query parameters

- `country` string, required: ISO country code, e.g. IE (required)
- `year` integer: Year (default current) (optional)

## Response `200`

Success

- object

## Other responses

- `402`: Payment Required: x402 exact scheme, USDC on Base

---

[API](https://skmtc.dev/gadgethumans/apis/gadgethumans-api-hub.md) · [All operations](https://skmtc.dev/gadgethumans/apis/gadgethumans-api-hub/llms.txt) · [OpenAPI document](https://skmtc.dev/gadgethumans/apis/gadgethumans-api-hub/revisions/7e0ce6386a0d?raw)