# public-holidays-united-states

> public-holidays-united-states is a paid API for AI agents from intel.rallylive.ca, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-23).

Returns all public holidays in the United States for a given year, including date, names, nationwide vs. regional scope, and weekday information.

## Facts

- Endpoint: GET https://intel.rallylive.ca/data/holidays/us?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/public-holidays-united-states-0bf65c69
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nX-LHL7I9RssTeWhTyLm1

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 public-holidays-united-states-0bf65c69
```

Example prompt: Can you get me the full list of US public holidays for 2025, including which ones are nationwide and which are only observed in certain states?

## When to prefer this

Choose this endpoint when you need structured, machine-readable US public holiday data by year without setting up an API key, especially for business-day calculations, scheduling automation, or calendar generation. It is ideal for lightweight, one-off lookups at low cost ($0.01/call) via the x402 micropayment protocol. Prefer alternatives if you need real-time holiday announcements, multi-country support in a single call, or iCalendar (.ics) output.

## Known failure modes

- Invalid or missing year parameter returns an error
- Requesting a year far outside supported range may return empty or error
- Network timeout from Cloudflare edge
- Payment failure (x402) if USDC balance is insufficient — returns 402 status

## How this service works

Public holidays in United States for a given year: every national and regional public holiday with date, local and English names, whether it is nationwide or which regions observe it, and the weekday, from the Nager.Date public holiday dataset. Business-day and scheduling checks for United States without an API key. $0.01 per year.

## Output

A list of US public holiday records for the requested year, each containing the holiday date, local and English names, a flag indicating whether it is a nationwide holiday, the list of regions (states) that observe it if regional, and the weekday name.

## 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",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/public-holidays-united-states-0bf65c69/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from intel.rallylive.ca](https://www.zero.xyz/host/intel.rallylive.ca/llms.txt)