Returns the public holidays (bank holidays, Feiertage) of a German federal state for one y
Returns the public holidays (bank holidays, Feiertage) of a German federal state for one year, each with date, weekday and the citation in that state's own act. Public holidays in Germany are state law; only 3 October is federal. Regionally limited ones (Assumption Day in Bavaria, Corpus Christi in Saxony and Thuringia) are flagged and do NOT apply statewide. All 16 state lists read against the statute, each with source and check date.
20000 (raw units)
price
1
calls / 30d
1
unique payers
2026-09-01
updated
Provider
api.ozdreamtools.de · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x4Dd5E59475A55f1C2c0816469600663cb74cC1Dc",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "20000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"body": {
"state": "BY",
"year": 2026
},
"bodyType": "json",
"method": "POST",
"type": "http"
},
"output": {
"example": {
"holidays": [
{
"date": "2026-06-04",
"key": "fronleichnam",
"name": "Fronleichnam",
"scope": "statewide",
"weekday": "Thursday"
},
{
"date": "2026-08-15",
"key": "mariae_himmelfahrt",
"name": "Mariä Himmelfahrt",
"restriction": "only in municipalities with a predominantly Catholic population …",
"scope": "regionally_limited",
"weekday": "Saturday"
}
],
"legal_basis": {
"checked_at": "2026-07-23",
"citation": "Art. 1 FTG",
"source": "…",
"statute": "Feiertagsgesetz (FTG), Bayern"
},
"note": "…",
"state": "BY",
"state_name": "Bayern",
"year": 2026
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"properties": {
"state": {
"description": "Federal state code: BW BY BE BB HB HH HE MV NI NW RP SL SN ST SH TH",
"type": "string"
},
"year": {
"description": "Calendar year, 1583 to 2200 (validity range of the Gregorian Easter formula).",
"type": "integer"
}
},
"required": [
"year",
"state"
]
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://api.ozdreamtools.de/api/holidays" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://api.ozdreamtools.de/api/holidays");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://api.ozdreamtools.de/api/holidays")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/3613.json, and this resource appears in /discovery/resources and /discovery/search.