{"uid":"cap_126rsMS2ZKwH0CR2kzGVr","slug":"usaref-public-holidays-by-country-8a287178","name":"usaref Public Holidays by Country","description":"North American government reference data for 10 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://usaref.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_bsxOoAqOTXoPnVf7IJZFp","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 North American country, cited to the official gazette or government source with dates and descriptions","exampleAgentPrompt":"What are the official public holidays in Mexico this year? I need the dates cited to the government source.","exampleUseCases":[{"title":"Payroll compliance holiday calendar","prompt":"Pull the official government-cited public holidays for Canada so I can flag statutory days in my payroll system and avoid processing payments on those dates."},{"title":"Working day scheduler for cross-border projects","prompt":"I'm scheduling deliverables between the US and Mexico — can you get me the official public holidays for both countries so I know which dates to skip?"},{"title":"HR policy builder for regional team","prompt":"We're writing a leave policy for our Costa Rica office. Get me the full list of official public holidays there, with the government source so we can cite it in the policy document."}],"resultDescription":"A JSON array of public holidays for the requested country, each entry including the holiday date, name or description, official source URL (gazette or government site), and a last-confirmed date indicating when the data was verified. A staleness flag may also be present.","failureModes":["Country not supported — endpoint returns an error or refusal for countries outside the covered 10","Invalid country code or name — malformed path parameter returns 4xx error","Payment failure — x402 payment not completed results in 402 response","Stale data warning — last_confirmed date is old, stale flag may be set","Rate limit exceeded on free tier — exceeds 50 free calls per day"],"whenToPreferThis":"Choose this endpoint when you need authoritative, gazette-cited public holiday data for North American countries with source provenance and confirmation dates — especially for compliance, payroll, or legal use cases where an official citation matters. Prefer over generic holiday APIs when you need the official source URL and last-confirmed date. Use the working-days sibling endpoint if you need to compute working days across a date range rather than just list holidays.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T06:42:30.001Z","isFirstParty":false,"canonicalSlug":"usaref-public-holidays-by-country-8a287178"}