# Public Holidays by Country and Year

> Public Holidays by Country and Year is a paid API for AI agents from agent-data-tools.revmesh2074.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-19).

Returns all public holidays for a given country and year, including date, local and English name, nationwide flag, and observed day.

## Facts

- Endpoint: GET https://agent-data-tools.revmesh2074.workers.dev/holidays/public?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-19
- Activations on Zero: 0
- Provider: agent-data-tools.revmesh2074.workers.dev
- Website: https://agent-data-tools.revmesh2074.workers.dev
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-public-holidays-by-country-e53fbdc7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Wh0yL9gb11pQEchNS26b4

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 agent-data-tools-revmesh2074-workers-dev-public-holidays-by-country-e53fbdc7
```

Example prompt: Can you list all the public holidays in Japan for 2025, including their local names and whether each one is nationwide?

## When to prefer this

Use this endpoint when you need machine-readable public holiday data for any of 100+ countries, especially for scheduling, logistics, or business-day calculations. It supports future years up to 2100, returns observed dates alongside official dates, and flags whether each holiday is nationwide — making it more useful than a simple calendar lookup when regional or observed-day accuracy matters.

## Known failure modes

- Invalid or unrecognized country code returns an error or empty holidays array
- Year outside supported range (2024-2100) may return an error or no results
- Country with no data coverage returns empty holidays list
- Misspelled country name may fail to match — prefer ISO alpha-2 codes
- Missing required 'country' parameter returns a 400-level error

## How this service works

Public holidays for a country and year: date, local and English name, whether it is nationwide and the observed day, for over 100 countries. Use to plan deliveries, schedules and business days, or to tell whether today is a holiday somewhere.

## Output

A JSON object containing the country name, year, total holiday count, and an array of holiday objects — each with the ISO date, English name, local name, observed date (if different), a boolean for whether it is nationwide, and an array of type tags (e.g. public, bank, optional).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "country"
 ],
 "properties": {
  "year": {
   "type": "integer",
   "description": "Year, 2024-2100 (default this year)"
  },
  "country": {
   "type": "string",
   "description": "ISO 3166-1 alpha-2 code (US, GB, SE, JP, CA…) or English country name"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "note": {
   "type": "string"
  },
  "year": {
   "type": "number"
  },
  "count": {
   "type": "number"
  },
  "country": {
   "type": "string"
  },
  "holidays": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "date": {
      "type": "string"
     },
     "name": {
      "type": "string"
     },
     "types": {
      "type": "array",
      "items": {
       "type": "string"
      }
     },
     "observed": {},
     "localName": {
      "type": "string"
     },
     "nationwide": {
      "type": "boolean"
     }
    }
   }
  },
  "countryName": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-public-holidays-by-country-e53fbdc7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data-tools.revmesh2074.workers.dev](https://www.zero.xyz/host/agent-data-tools.revmesh2074.workers.dev/llms.txt)
