# ForgeMesh Public Holidays API

> ForgeMesh Public Holidays API is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns official national public holidays (date, local name, English name, and type) for any of 200+ countries and any year as JSON

## Facts

- Endpoint: POST https://x402.forgemesh.io/public-holidays
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-public-holidays-api-a4d9f6f0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-FYLt5y5FjVYHXxs5JHta

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 forgemesh-public-holidays-api-a4d9f6f0 -d '<json body>'
```

Example prompt: Can you pull the official public holidays for Germany in 2026 — I need the dates, local names, and whether each one is a public, bank, or school holiday?

## When to prefer this

Prefer this endpoint when you need authoritative, structured national holiday data for any of 200+ countries across any year without relying on a third-party upstream service. Ideal for scheduling agents, payroll systems, SLA checkers, and delivery planners that need to verify whether a date is a working day. Useful when low-latency, self-contained holiday lookups are required at $0.003 per call.

## Known failure modes

- Invalid or unsupported 2-letter country code — returns error or empty result
- Year out of supported range — returns error or empty result
- Malformed request body — returns validation error
- Temporary service unavailability — returns HTTP 5xx
- Payment failure or insufficient USDC balance — returns HTTP 402

## How this service works

Public holidays API: the official public holidays for any country (110+ supported) and year — date, local name, English name, nationwide flag, and observing subdivisions as JSON. The data scheduling, payroll, SLA, and delivery agents check before promising a date. Cached 24 hours.

## Output

A JSON array of holiday objects for the specified country and year, each containing the date, local name, English name, and holiday type (public, bank, school, or observance). Data is served from a locally bundled dataset with no third-party dependency at request time, covering 200+ countries.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "year": {
   "type": "string",
   "description": "default 2026"
  },
  "country": {
   "type": "string",
   "description": "2-letter code, default US"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "date": "2026-07-03",
    "name": "Independence Day",
    "fixed": true,
    "types": [
     "Public"
    ],
    "global": true,
    "counties": null,
    "localName": "Independence Day",
    "launchYear": null,
    "countryCode": "US"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-public-holidays-api-a4d9f6f0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)