{"uid":"cap_K2GkX2jvl9QOJH9tdjLQg","slug":"mearef-middle-east-public-holidays-7698f624","name":"Mearef Middle East Public Holidays","description":"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.","url":"https://mearef.dev/v1/holidays/:country?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4MPRbJzdJzqLWM6qrU_4_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns public holidays for a specified Middle Eastern country, cited to official government or gazette sources, with optional year filtering.","exampleAgentPrompt":"What are the official public holidays in the UAE for 2025? I need the dates, names, and government sources.","exampleUseCases":[{"title":"Plan payroll around Saudi holidays","prompt":"I need to know all official public holidays in Saudi Arabia for 2025 — give me the dates and names, cited to the official source, so I can plan our payroll schedule around them."},{"title":"Verify Qatar holiday gazette citation","prompt":"Can you pull the government-cited public holidays for Qatar and show me the source URLs so I can confirm they're from the official gazette?"},{"title":"Build a Jordan business calendar","prompt":"Get me all public holidays in Jordan for 2024 with their official dates and last-confirmed timestamps so I can build an accurate business calendar for the year."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T18:33:20.350Z","isFirstParty":false,"canonicalSlug":"mearef-middle-east-public-holidays-7698f624"}