{"uid":"cap_gDn18jGp4YhLWOmaIbQVI","slug":"mearef-public-holidays-by-country-8005e7d7","name":"Mearef Public Holidays by Country","description":"Middle Eastern government reference data for 9 countries as cited JSON: central-bank policy rates, VAT/GST and VAT registration thresholds, CPI, corporate, personal and withholding tax, social contributions, minimum wages, statutory interest, official FX rates, filing deadlines and public holidays (coverage varies by country). Every value carries its official source URL and last-confirmed date. Single facts $0.003; country brief (every series for one country) $0.01; cross-country compare (one series, up to 10 countries) $0.02; tax-ID and VAT-number checks $0.003; computed answers (VAT, income tax, working days, minimum-wage check) $0.01-$0.02. Pay per call in USDC on Base via x402 or MPP, no signup, or by card with credit packs or monthly plans on one key valid across all 7 regional services. Free tier: GET /catalog, plus a free email key with 50 answer calls a day, commercial use allowed. Finished answers, one cited dossier per call (supported countries vary per job; others are refused free): cost this hire (wage-floor verdict, contributions, employer cost) $0.50; charge this sale (which VAT applies, net/VAT/gross) $0.50; charge this sale certified (plus a signed VAT-rate extract) $0.75; invoice due date and statutory late interest $0.40; country evidence pack (brief plus signed extracts) $0.25; hire compare $0.75 for 2 countries, $1.00 for 3-5; next filings (VAT, PAYE, corporate-tax due dates rolled for holidays) $0.35.\n\nFree trial: 3 computed-answer calls per day per IP on POST /v1/answers/* with header X-Free-Trial: 1 (without it, the normal x402 402; once used up, the 402 carries free_trial_resets_at). MCP answer tools use the trial automatically when no api_key is passed. Every series of the evaluation country is free. Card credit (same per-call price as x402): /pricing.","url":"https://mearef.dev/v1/holidays/%7Bcountry%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"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_tWpa-OLIDVUCiQW4QQZTV","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 official public holidays for a specified Middle Eastern country, cited to the official gazette or government source with dates and metadata.","exampleAgentPrompt":"Can you pull the official public holidays for Saudi Arabia from mearef, with their gazette citations and confirmed dates?","exampleUseCases":[{"title":"Business travel planning for Gulf region","prompt":"What are the official public holidays in the UAE this year? I need the government-cited list so I can avoid scheduling meetings on those days."},{"title":"Payroll compliance check for Jordan","prompt":"Get me the statutory public holidays in Jordan for 2024 — I need the official source citations so our payroll team can verify which days require holiday pay."},{"title":"Working-days calculation for contract deadline","prompt":"Pull the official public holidays in Egypt so I can figure out how many working days are left before the end of the quarter for our contract deadline."}],"resultDescription":"A JSON array of public holidays for the requested country, each entry including the holiday date, name, official gazette or government source URL, and the last-confirmed date. Coverage and number of entries varies by country.","failureModes":["Unsupported country returns an error or empty response — coverage is limited to the 9 supported Middle Eastern countries","Stale data flag if the official source has not been re-confirmed recently","Invalid or unrecognized country code/name returns a 400 or 404 error","Network or payment failure (x402 protocol) if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need authoritative, gazette-cited public holiday data for Middle Eastern countries with traceable official sources — ideal for compliance, payroll, contract, or scheduling workflows where citation provenance matters. Prefer over generic holiday APIs when operating in the Middle East region and needing source verification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-25T00:37:19.347Z","isFirstParty":false,"canonicalSlug":"mearef-public-holidays-by-country-8005e7d7"}