get_public_holidays_worldwide
Read-onlyIdempotent
FREE with any API key, including the free key by email (https://afriref.dev/free-key). Same as get_public_holidays, but for every country across all seven brands, not only Pan-African. Unmetered: never counts against the key's allowance. Pass api_key, or send the key as the X-API-Key header on /mcp.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| api_key | No | Any valid API key. Optional when the key is sent as the X-API-Key header on /mcp. | |
| country | Yes | ISO country code, any covered country | |
| subdivision | No | Optional ISO 3166-2 region code (e.g. 'DE-BY'). Returns national + that region's statutory holidays, each tagged national/regional. Omit for the national calendar. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| unit | No | ||
| error | No | Present on a free refusal or error; no charge | |
| notes | No | ||
| stale | No | ||
| value | No | ||
| series | No | ||
| source | No | ||
| country | No | ||
| no_charge | No | ||
| price_usd | No | ||
| confidence | No | ||
| disclaimer | No | ||
| how_to_pay | No | ||
| bind_series | No | ||
| explanation | No | ||
| label_basis | No | Inputs and the rule ids that produced the two labels | |
| subdivision | No | ||
| x_next_bind | No | ||
| http_endpoint | No | ||
| coverage_label | No | How much of the question is covered: ready = complete; partial = held with a disclosed limitation or default; gap = no number served. Rules at /label-rules | |
| effective_from | No | ||
| last_confirmed | No | ||
| confidence_label | No | Evidence verdict derived from source type, verification age and the stale flag (answers: the weakest series read). Rules at /label-rules | |
| payment_required | No | true when the call needs payment; how_to_pay explains x402 or card | |
| available_subdivisions | No |