Returns the public holidays (bank holidays, Feiertage) of a German federal state
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.
Answeringour last check, 2026-09-24
1 of 1checks answered this week
433 msmedian answer time
$0.02listed price per call
$0.02price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://api.ozdreamtools.de/api/holidays
| Category | Everything else |
|---|---|
| Provider host | api.ozdreamtools.de |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 3 from 2 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-24 | valid payment request | 402 | $0.02 | 433 ms |
Example input (from the provider)
{
"body": {
"state": "BY",
"year": 2026
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$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"
}