# SkyFeed Public Holidays Lookup

> SkyFeed Public Holidays Lookup is a paid API for AI agents from skyfeed.imac2014ville.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-10).

Returns public holidays for a given country and year using the Nager.Date open-source dataset.

## Facts

- Endpoint: GET https://skyfeed.imac2014ville.workers.dev/holidays?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/skyfeed-public-holidays-lookup-b178bea2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AyapZ6BPn6QI5WSaHIRCv

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 skyfeed-public-holidays-lookup-b178bea2
```

Example prompt: What are all the public holidays in Japan for 2026? Give me the dates, names, and whether each one is nationwide.

## When to prefer this

Choose this endpoint when you need structured, machine-readable public holiday data for a specific country and year, especially in agentic workflows that need to plan around non-working days, check compliance calendars, or enrich scheduling data. It is pay-per-call with no API key required, making it ideal for low-volume or on-demand lookups via x402/USDC on Base. Prefer it over scraping or static CSV datasets when freshness and structured output matter.

## Known failure modes

- Missing or invalid country code returns an error — must be valid ISO 3166-1 alpha-2
- Year out of range (outside 1990–2100) may return an error or empty result
- Payment failure (insufficient USDC balance on Base) results in 402 response before any data is returned
- Country not supported by Nager.Date returns empty holiday list or error
- No holidays found for given year/country combination returns count of 0 with empty array

## How this service works

Pay-per-call weather forecasts (global), current conditions, US severe-weather alerts, earthquakes, public holidays and a bundled travel check for AI agents. No API key: pay USDC on Base per call via x402.

## Output

Returns a JSON object with the year, country code, total count of holidays, the data source (Nager.Date), and an array of holiday objects each containing the ISO date, English name, local name, holiday types (e.g. Public, Bank), applicable regions (null if nationwide), and a boolean nationwide flag.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country"
     ],
     "properties": {
      "year": {
       "type": "number",
       "description": "Year 1990-2100 (default current year)"
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 code, e.g. US, DE, JP"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "year": 2026,
  "count": 1,
  "source": "Nager.Date (open-source, MIT)",
  "country": "US",
  "holidays": [
   {
    "date": "2026-01-01",
    "name": "New Year's Day",
    "types": [
     "Public",
     "Bank"
    ],
    "regions": null,
    "localName": "New Year's Day",
    "nationwide": true
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/skyfeed-public-holidays-lookup-b178bea2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from skyfeed.imac2014ville.workers.dev](https://www.zero.xyz/host/skyfeed.imac2014ville.workers.dev/llms.txt)