# German Federal State Public Holidays API

> German Federal State Public Holidays API is a paid API for AI agents from api.ozdreamtools.de, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns the official public holidays (Feiertage) for a specified German federal state and year, with dates, weekdays, statutory citations, and regional applicability flags

## Facts

- Endpoint: POST https://api.ozdreamtools.de/api/holidays
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/german-federal-state-public-holidays-api-ad1f2ef2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__AtsqJ3pkoltwRc9qc1WB

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability german-federal-state-public-holidays-api-ad1f2ef2 -d '<json body>'
```

Example prompt: Can you get me the full list of public holidays in Bavaria for 2025, including which ones are only regionally valid and the statute they come from?

## When to prefer this

Use this endpoint when you need authoritative, statute-cited German public holiday data for a specific federal state, especially when you need to know whether a holiday applies statewide or only regionally (e.g. Assumption Day in Bavaria, Corpus Christi in Saxony). Prefer this over generic calendar APIs when legal accuracy and statutory references matter, such as for payroll, HR systems, legal deadline calculation, or compliance tooling in Germany.

## Known failure modes

- Invalid or unrecognized state code returns an error
- Year out of supported range returns an error
- Missing required parameters (state or year) returns a validation error
- Network timeout on the POST request

## How this service works

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.

## Output

A structured list of public holidays for the requested German federal state and year, each entry containing the holiday name, date, weekday, the specific clause of the state act authorizing it, and a flag indicating whether the holiday is limited to a region within the state (rather than applying statewide)

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "year": {
   "type": "integer",
   "description": "Calendar year, 1583 to 2200 (validity range of the Gregorian Easter formula)."
  },
  "state": {
   "type": "string",
   "description": "Federal state code: BW BY BE BB HB HH HE MV NI NW RP SL SN ST SH TH"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/german-federal-state-public-holidays-api-ad1f2ef2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ozdreamtools.de](https://www.zero.xyz/host/api.ozdreamtools.de/llms.txt)