# auor.io Open Holidays - School Holidays

> auor.io Open Holidays - School Holidays is a paid API for AI agents from api.auor.io, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns school holiday information for a given country and date range via the OpenHolidays API

## Facts

- Endpoint: GET https://api.auor.io/open-holidays/v1/school
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/auor-io-open-holidays-school-holidays-939d6400
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_stcHV3hp9VAC_qNuj9Ja2

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 auor-io-open-holidays-school-holidays-939d6400
```

Example prompt: What are the school holidays in Germany for 2025? I need the dates for Bavaria (subdivision BY) in German language.

## When to prefer this

Use this endpoint when you need structured school holiday data for a specific country or region, especially when building travel planners, scheduling tools, or educational calendars. Prefer this over public holiday endpoints when specifically needing school break dates rather than national public holidays.

## Known failure modes

- Missing required query parameters returns 400 Bad Request
- Invalid country code returns empty results or 404
- Unsupported subdivision code returns error
- Date range too wide may return large payload or timeout
- Payment failure (402) if x402 micropayment not completed
- Unsupported language code may fall back to default or error

## How this service works

School holiday information

## Output

A list of school holiday entries for the queried country/subdivision and date range, each including the holiday name, start date, end date, and regional applicability.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "$ref": "https://api.auor.io/schemas/open-holidays/v1/school/input.json",
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/auor-io-open-holidays-school-holidays-939d6400/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.auor.io](https://www.zero.xyz/host/api.auor.io/llms.txt)