---
title: "Public Holiday Lookup (x402)"
method: GET
path: "/x402/v2/public-holiday-lookup"
tags: ["x402"]
---

# Public Holiday Lookup (x402)

`GET /x402/v2/public-holiday-lookup`

## Request

- Base URL: `https://api.strale.io`
- URL: `https://api.strale.io/x402/v2/public-holiday-lookup`
- Auth: none required

Get public holidays by country and year for the 200+ countries covered by Nager.Date. Returns holiday dates, names, and next upcoming.

## Query parameters

- `year` number
- `country_code` string, required

## Response `200`

Success

- object
  - `holidays` unknown[]
    - unknown
  - `next_upcoming` object
  - `total_holidays` number

## Other responses

- `402`: Payment required (x402 — pay with USDC on Base)

---

[API](https://skmtc.dev/strale/apis/strale-api-2.md) · [All operations](https://skmtc.dev/strale/apis/strale-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/strale/apis/strale-api-2/revisions/a5293878cfc6?raw)