# Mearef Middle East Public Holidays

> Mearef Middle East Public Holidays is a paid API for AI agents from mearef.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-23).

Returns public holidays for a specified Middle Eastern country, cited to official government or gazette sources, with optional year filtering.

## Facts

- Endpoint: GET https://mearef.dev/v1/holidays/:country?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/mearef-middle-east-public-holidays-7698f624
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_K2GkX2jvl9QOJH9tdjLQg

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 mearef-middle-east-public-holidays-7698f624
```

Example prompt: What are the official public holidays in the UAE for 2025? I need the dates, names, and government sources.

## When to prefer this

Choose this endpoint when you need authoritative, gazette-cited public holiday data for Middle Eastern countries specifically. It is preferable over generic holiday APIs when source verification and official citation traceability are important, or when your use case involves compliance, payroll, or legal scheduling for the region. The x402 micropayment model makes it suitable for per-call agent workflows without subscription overhead.

## Known failure modes

- Unsupported country code returns 404 or empty result — only Middle Eastern countries are covered
- Invalid or missing country path parameter returns a 400 or error response
- Year filter returns empty list if no holidays are recorded for that year
- Stale data if last_confirmed is old and government has not yet announced the next year's holidays
- Payment failure (x402) if USDC balance is insufficient

## How this service works

Middle Eastern public holidays by country, cited to the official gazette or government source: date, name, source URL, last_confirmed. ?year=YYYY to filter. GET /v1/holidays/{country}, e.g. /v1/holidays/ae.

## Output

Returns a JSON list of public holidays for the specified country, each including the date, holiday name, official source URL (linked to government gazette or official publication), and a last_confirmed field indicating when the data was verified. Optionally filtered to a single calendar year via the ?year=YYYY query parameter.

## 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": true
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/mearef-middle-east-public-holidays-7698f624/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mearef.dev](https://www.zero.xyz/host/mearef.dev/llms.txt)