# Holidays Get Holidays

> Returns a list of public holidays for the specified country and year

- Skill: `gabrielmoreira/holidays-get-holidays` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/holidays-get-holidays`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/holidays-get-holidays/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: gabrielmoreira (https://skillmd.com/u/gabrielmoreira)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/gabrielmoreira/holidays-get-holidays

---


## Endpoint

**GET https://requiems.xyz/v1/places/holidays**

## Get Holidays

Returns a list of public holidays for the specified country and year

## Parameters

| Name | Type | Required | Location | Description |
| ---- | ---- | -------- | -------- | ----------- |
| `country` | string | yes | query | ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "DE") |
| `year` | integer | yes | query | Year for which to retrieve holidays (e.g., 2025) |

## Response Example

```json
{
  "data": {
    "country": "US",
    "year": 2025,
    "holidays": [
      {
        "date": "2025-01-01",
        "name": "New Year's Day"
      },
      {
        "date": "2025-07-04",
        "name": "Independence Day"
      }
    ],
    "total": 11
  },
  "metadata": {
    "timestamp": "2025-01-15T10:30:00Z"
  }
}
```

## Response Fields

| Field | Type | Description |
| ----- | ---- | ----------- |
| `country` | string | ISO 3166-1 alpha-2 country code |
| `year` | integer | Year for which holidays are returned |
| `holidays` | array<object> | Array of holiday objects |
| `holidays[].date` | string | Holiday date in YYYY-MM-DD format |
| `holidays[].name` | string | Name of the holiday |
| `total` | integer | Total number of holidays for the country/year |

## Errors

- `400` **bad_request** — Missing or invalid country code or year parameter
- `404` **not_found** — No holidays found for the specified country and year