{"uid":"cap_d7zQ4d-Z18KwgWcQXrEmY","slug":"afriref-dev-working-days-reference-data-series-c23c9559","name":"afriref.dev Working Days / Reference Data Series","description":"Working days in a date range: weekends + public holidays applied, next working day","url":"https://afriref.dev/v1/answers/working-days?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["country","from","to"],"properties":{"to":{"type":"string","format":"date","description":"Range end, inclusive (max 366 days)"},"from":{"type":"string","format":"date","description":"Range start, inclusive"},"country":{"enum":["ao","bf","bj","bw","cd","cf","cg","ci","cm","dz","eg","et","ga","gh","gq","ke","ls","ma","ml","mu","mz","na","ne","ng","rw","sn","sz","td","tg","tn","tz","ug","za","zm"],"type":"string","description":"ISO country code"},"receipt":{"type":"boolean","description":"Optional. true adds an Ed25519 answer receipt on a paid 200, incluedd in this price. Not a certified extract."},"subdivision":{"type":"string","description":"Optional. Apply a sub-national statutory holiday calendar (national + that region's days) instead of national-only. ISO 3166-2 code, e.g. 'DE-BY'. Countries that offer regions expose them as `subdivisions` on GET /:country/public-holidays. Unknown code is refused free with the list."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["status","total_days","working_days","next_working_day"],"properties":{"status":{"type":"string"},"caveats":{"type":"array"},"receipt":{"type":"object","description":"Only when receipt=true on a paid 200. kind answer_receipt. Verify at /certified/public-key."},"weekend":{"type":"array","description":"This country's weekly rest days (Egypt: Fri–Sat)"},"disclaimer":{"type":"string"},"provenance":{"type":"object","description":"The statutory instrument the answer rests on: effective_from, last_confirmed, official source URL, notes"},"total_days":{"type":"integer"},"subdivision":{"type":["object","null"],"description":"The sub-national calendar applied (code, name, source, the region's added days), or null when the national calendar was used"},"weekend_days":{"type":"integer"},"working_days":{"type":"integer"},"public_holidays":{"type":"array","description":"Statutory holidays falling on weekdays in the range"},"next_working_day":{"type":"string","format":"date"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Vnve30ktgAginKGXqVqVn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a specific government reference data series (e.g. public holidays, VAT, policy rate) for a given African country","exampleAgentPrompt":"What are the public holidays in Kenya according to official government records — I need the current list with dates and names, and flag if the data might be stale.","exampleUseCases":null,"resultDescription":"A JSON object containing the country code, series identifier, current value (a number for rates/wages or an array of {date, name} objects for holiday calendars), the effective date, last confirmed date, source name and URL, a staleness flag, optional unit, notes, and for composite rates like Ghana VAT, a breakdown of statutory components and the effective combined rate.","failureModes":["Unsupported country code returns validation error — only 11 African countries are supported (ci, eg, et, gh, ke, ma, ng, rw, sn, tz, ug)","Unsupported series type returns validation error — only 7 series are available (policy-rate, vat, minimum-wage, public-holidays, cpi, corporate-tax, income-tax)","stale=true in response means the data is past its expected update cycle and should be treated with caution","Payment failure (402) if x402 micropayment not completed","Missing required path params (country or series) returns 400"],"whenToPreferThis":"Use this endpoint when you need official, sourced government reference data for African countries — specifically fiscal rates (VAT, corporate tax, income tax, policy rate), labor data (minimum wage), economic indicators (CPI), or public holiday calendars. Prefer this over web scraping or generic knowledge when you need a structured, attributed, freshness-flagged response for one of the 11 supported countries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T19:10:45.122Z","isFirstParty":false,"canonicalSlug":"afriref-dev-working-days-reference-data-series-c23c9559"}