# Holidays Post Batch

> Returns holidays for up to 50 (country, year) pairs in a single request. Each pair is processed independently — if one combination has no data, it returns found:false without failing the entire batch.

- Skill: `gabrielmoreira/holidays-post-batch` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gabrielmoreira/holidays-post-batch`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gabrielmoreira/holidays-post-batch/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-post-batch

---


## Endpoint

**POST https://requiems.xyz/v1/places/holidays/batch**

## Batch Get Holidays

Returns holidays for up to 50 (country, year) pairs in a single request. Each pair is processed independently — if one combination has no data, it returns found:false without failing the entire batch.

## Parameters

| Name | Type | Required | Location | Description |
| ---- | ---- | -------- | -------- | ----------- |
| `queries` | array<object> | yes | body | Array of (country, year) pairs. Min: 1, Max: 50. |

## Response Example

```json
{
  "data": {
    "results": [
      {
        "country": "US",
        "year": 2025,
        "found": true,
        "holidays": [
          { "date": "2025-01-01", "name": "New Year's Day" },
          { "date": "2025-07-04", "name": "Independence Day" }
        ],
        "total": 11
      },
      {
        "country": "AR",
        "year": 2024,
        "found": true,
        "holidays": [
          { "date": "2024-01-01", "name": "Año Nuevo" }
        ],
        "total": 19
      },
      {
        "country": "AQ",
        "year": 2025,
        "found": false
      }
    ],
    "total": 3
  },
  "metadata": {
    "timestamp": "2025-01-15T10:30:00Z"
  }
}
```

## Response Fields

| Field | Type | Description |
| ----- | ---- | ----------- |
| `results` | array<object> | One result per query, in the same order as the request |
| `results[].country` | string | ISO 3166-1 alpha-2 country code |
| `results[].year` | integer | Year queried |
| `results[].found` | boolean | false when no holidays exist for that country/year combination |
| `results[].holidays` | array<object> | List of holidays. Omitted when found is false. |
| `results[].total` | integer | Number of holidays. Omitted when found is false. |
| `total` | integer | Total number of results (equals the number of queries sent) |

## Errors

- `400` **bad_request** — Malformed request body
- `422` **validation_failed** — queries is missing, empty, exceeds 50 items, or contains invalid country codes or years