get_public_holidays
Read-onlyIdempotent
FREE. Official public-holiday calendar for a supported country, including gazetted movable holidays, with the official government source cited. Some countries also carry sub-national calendars (e.g. the German Laender): the subdivisions field lists them, and passing subdivision (ISO 3166-2, e.g. 'DE-BY') returns the national calendar merged with that region's statutory days.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | Yes | ISO country code | |
| 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 |