# Public Holidays by Country and Year

> Public Holidays by Country and Year is a paid API for AI agents from x402-data-bazaar.vercel.app, paid per call via x402, $0.008/call, status down (last checked 2026-09-15).

Returns a list of public holidays for a given country and year using ISO 3166-1 alpha-2 country codes

## Facts

- Endpoint: GET https://x402-data-bazaar.vercel.app/api/holidays/US/2026
- Price: $0.008/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-data-bazaar-vercel-app-afbe9f4e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9dykP0Z0JKwUdF9A8Jk5p

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability x402-data-bazaar-vercel-app-afbe9f4e
```

Example prompt: What are all the public holidays in the US for 2026? I need the dates and names of each one.

## When to prefer this

Use this endpoint when you need a structured, machine-readable list of public holidays for any country and year, especially for scheduling, workforce planning, calendar apps, or date-aware automation. Prefer this over scraping Wikipedia or government sites when you need clean JSON output with global-holiday flags.

## Known failure modes

- Invalid or unsupported country code returns an empty holidays array or error
- Year out of supported range may return no data
- Malformed country code (e.g. 3-letter code instead of 2-letter) causes a 400 or empty response
- Network or upstream Nager.Date API unavailability causes a 500 error

## How this service works

Public holidays for any country and year. Use ISO 3166-1 alpha-2 country codes. e.g. GET /api/holidays/US/2026

## Output

Returns a JSON object with the year, country code, total holiday count, and an array of holiday objects each containing the date (ISO 8601), holiday name, and a boolean indicating whether it is a globally observed holiday. Sourced from the Nager.Date API.

## Response schema (JSON Schema)

```json
{
 "data": {
  "year": 2026,
  "count": 16,
  "country": "US",
  "holidays": [
   {
    "date": "2026-01-01",
    "name": "New Year's Day",
    "global": true
   },
   {
    "date": "2026-01-19",
    "name": "Martin Luther King, Jr. Day",
    "global": true
   }
  ]
 },
 "source": "Nager.Date API",
 "success": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-data-bazaar-vercel-app-afbe9f4e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-data-bazaar.vercel.app](https://www.zero.xyz/host/x402-data-bazaar.vercel.app/llms.txt)