# Rotary Agency Holidays API

> Rotary Agency Holidays API is a paid API for AI agents from rotaryagency.uk, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-20).

Returns public holiday data for a given country and year via a free-source, no-proxy data feed

## Facts

- Endpoint: GET https://rotaryagency.uk/api/free/holidays?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rotary-agency-holidays-api-9f37e47d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_UXNvBAdbTa4eObwCyj-km

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 rotary-agency-holidays-api-9f37e47d
```

Example prompt: Can you pull up all the public holidays in the UK for 2025? I need to know which dates to block off in our scheduling system.

## When to prefer this

Choose this endpoint when you need a low-cost ($0.002/call), no-frills public holiday lookup without going through a large calendar platform. Best suited for agents doing lightweight scheduling checks, payroll compliance, or itinerary planning where a single country/year lookup suffices and cost efficiency matters.

## Known failure modes

- Unsupported country code returns empty array or error
- Invalid year format may result in a 400 or empty response
- Rate limiting or payment failures return 402 or 429 status
- Sparse metadata means exact query parameter names are undocumented and may require probing

## How this service works

Free-source data APIs (100% margin, no proxy, $0.002/call): ...

## Output

Returns a structured JSON array of public holidays for the specified country and year, including each holiday's name, date, and type (e.g. national, regional, bank holiday).

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "varies": "endpoint-specific structured JSON"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rotary-agency-holidays-api-9f37e47d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rotaryagency.uk](https://www.zero.xyz/host/rotaryagency.uk/llms.txt)