{"uid":"cap_vVrCle_8tLOZTTacvI74W","slug":"afriref-public-holidays-by-country-9b328da9","name":"Afriref Public Holidays by Country","description":"Pan-African 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/gh.","url":"https://afriref.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_-SaRLH8-ibxQes_WrhoIi","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 gazette-cited public holidays for an African country, optionally filtered by year, with source URLs and last-confirmed dates.","exampleAgentPrompt":"Can you pull the official public holidays for Ghana (country code 'gh') in 2025, with their gazette sources and last-confirmed dates?","exampleUseCases":[{"title":"HR payroll compliance in Kenya","prompt":"I need the full list of official public holidays in Kenya for 2025 — cited to the government gazette — so I can make sure our payroll system skips the right days."},{"title":"Travel itinerary planning for Nigeria","prompt":"What are all the public holidays in Nigeria this year? I want to avoid scheduling meetings on those days during my visit."},{"title":"Pan-African app localization","prompt":"Fetch the gazetted public holidays for South Africa — country code 'za' — so I can highlight non-working days in our scheduling app for users there."}],"resultDescription":"A JSON array of public holidays for the requested African country, each entry containing the holiday date, official name, source URL (gazette or government link), and a last_confirmed timestamp. When a year query parameter is provided, results are filtered to that calendar year only.","failureModes":["Unsupported or invalid country code returns a 404 or error response","Country not yet covered by Afriref returns empty array or 404","Invalid year format in query parameter may return 400 or unfiltered results","Payment failure (x402) if USDC balance is insufficient","Stale data if government has not yet confirmed current-year holidays"],"whenToPreferThis":"Choose this endpoint when you need authoritative, gazette-cited public holiday data for African countries — especially when compliance, payroll, or legal accuracy requires traceable government sources. It is preferable over generic holiday APIs that lack source citations or African country coverage, and over manual research that cannot scale across 50+ African jurisdictions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T12:34:11.148Z","isFirstParty":false,"canonicalSlug":"afriref-public-holidays-by-country-9b328da9"}