{
  "openapi": "3.1.0",
  "info": {
    "title": "Ski4me: offene Schnittstelle",
    "version": "1.0.0",
    "description": "Der Zugang eines Betriebs zu seinen eigenen Daten: Buchungen, Tour, Unterkünfte, Einstellungen, Katalog und vermittelte Kurse.\n\nAngemeldet wird mit einem Schlüssel, den ein Admin des Betriebs im Portal unter **Schnittstelle** anlegt. Er besteht aus einer Kennung und einem Geheimnis und wird zusammen gesendet:\n\n    Authorization: Bearer <kennung>.<geheimnis>\n\nDer Schlüssel bestimmt den Betrieb. Der Host der Anfrage wird nicht gelesen.\n\nBeträge sind ganze Zahlen in Cent, Datumsangaben `JJJJ-MM-TT`, Zeitstempel ISO 8601 mit `Z`. Ein bekannter Pfad mit falscher Methode antwortet 405 mit `Allow` und nie 404. Geht etwas schief, nennt das Feld `hint` den nächsten Schritt.\n\nWas es hier nicht gibt: keine Zahlung, keine Rückzahlung, keine Daten eines anderen Betriebs.\n\nDieses Dokument ist die Beschreibung, die die Schnittstelle selbst unter `https://skirent.sumware.at/api/ext/openapi.json` ausliefert, ergänzt um Beispiele aus einem Mitschnitt gegen einen erfundenen Betrieb. Die Erklärungen dazu stehen unter https://docs.ski4.me.",
    "contact": {
      "name": "retail butlers GmbH",
      "email": "office@retail-butlers.at",
      "url": "https://ski4.me/kontakt"
    }
  },
  "servers": [
    {
      "url": "https://skirent.sumware.at",
      "description": "Plattform"
    }
  ],
  "security": [
    {
      "apiKey": []
    }
  ],
  "tags": [
    {
      "name": "Schlüssel",
      "description": "Wer ruft hier an"
    },
    {
      "name": "Buchungen",
      "description": "Lesen, anlegen, ändern"
    },
    {
      "name": "Tour",
      "description": "Aufträge des Tages und ihr Zustellstatus"
    },
    {
      "name": "Unterkünfte",
      "description": "Die Liste, aus der die Lieferadresse kommt"
    },
    {
      "name": "Einstellungen",
      "description": "Was der Betrieb an sich selbst einstellt"
    },
    {
      "name": "Preise",
      "description": "Katalog der aktiven Preisliste"
    },
    {
      "name": "Kurse",
      "description": "Was für die Skischule vermittelt wurde"
    }
  ],
  "components": {
    "securitySchemes": {
      "apiKey": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "kennung.geheimnis",
        "description": "Kennung und Geheimnis, getrennt durch einen Punkt.\nDas Geheimnis ist genau einmal sichtbar, direkt nach dem Anlegen.\n\nRechte, die ein Schlüssel tragen kann:\n\n- `day.view`: Tag, Tour, Zustellstatus, Unterkünfte und Einstellungen lesen\n- `job.complete`: Lieferung und Abholung als erledigt melden\n- `job.order`: Reihenfolge der Tour ändern\n- `booking.view`: Buchungen lesen, mit Gastdaten\n- `course.view`: vermittelte Kurse lesen, ohne die übrigen Buchungen\n- `booking.create`: Buchungen anlegen\n- `booking.edit`: Aufenthalt, Unterkunft, Zimmer und Notizen ändern\n- `booking.cancel`: Buchungen stornieren, ohne Geld zu bewegen; zurück zahlt der Admin im Portal\n- `accommodation.edit`: Unterkünfte anlegen, ändern, stilllegen\n- `price.view`: Katalog und Preisliste lesen\n- `settings.edit`: Einstellungen des Betriebs ändern\n- `stats.view`: Auswertungen lesen"
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code",
              "message",
              "status"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "Für Maschinen. Ändert sich nie.",
                "enum": [
                  "invalid_request",
                  "unauthorized",
                  "forbidden",
                  "not_found",
                  "method_not_allowed",
                  "conflict",
                  "rate_limited",
                  "service_unavailable",
                  "payment_unavailable",
                  "internal_error"
                ]
              },
              "message": {
                "type": "string",
                "description": "Für Menschen, in der Sprache der Anfrage."
              },
              "status": {
                "type": "integer"
              },
              "hint": {
                "type": "string",
                "description": "Nennt immer einen nächsten Schritt."
              },
              "documentation_url": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "examples": {
      "Unauthorized": {
        "summary": "Schlüssel fehlt oder gilt nicht",
        "value": {
          "error": {
            "code": "unauthorized",
            "message": "Der Schlüssel gilt nicht.",
            "status": 401,
            "hint": "Im Portal unter Einstellungen, Schnittstelle, einen gültigen Schlüssel anlegen.",
            "documentation_url": "https://skirent.sumware.at/api/"
          }
        }
      },
      "RateLimited": {
        "summary": "Zu viele Anfragen",
        "value": {
          "error": {
            "code": "rate_limited",
            "message": "Zu viele Anfragen in kurzer Zeit.",
            "status": 429,
            "hint": "In 46 Sekunden erneut versuchen.",
            "documentation_url": "https://skirent.sumware.at/api/"
          }
        }
      },
      "NotFound": {
        "summary": "Diesen Eintrag gibt es nicht",
        "value": {
          "error": {
            "code": "not_found",
            "message": "Diese Buchung gibt es nicht.",
            "status": 404,
            "hint": "Die Referenz prüfen.",
            "documentation_url": "https://skirent.sumware.at/api/"
          }
        }
      }
    }
  },
  "paths": {
    "/api/ext/v1/whoami": {
      "get": {
        "tags": [
          "Schlüssel"
        ],
        "operationId": "get-whoami",
        "summary": "Betrieb, Schlüssel und Rechte",
        "description": "Beim Start aufrufen und prüfen, ob der Schlüssel das darf, was vorgesehen ist. Das ist billiger, als beim ersten Schreibversuch auf 403 zu laufen.\n\nBraucht kein besonderes Recht.",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "tenant": {
                      "type": "object",
                      "properties": {
                        "slug": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "country": {
                          "type": "string"
                        },
                        "currency": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "slug",
                        "name",
                        "country",
                        "currency"
                      ],
                      "additionalProperties": {}
                    },
                    "key": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "name"
                      ],
                      "additionalProperties": {}
                    },
                    "scopes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "tenant",
                    "key",
                    "scopes"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "tenant": {
                    "slug": "talstation",
                    "name": "Skiverleih Talstation",
                    "country": "AT",
                    "currency": "EUR"
                  },
                  "key": {
                    "id": "01a1c478-a2b4-734d-827a-e37fd88d51e7",
                    "name": "Hotel Alpenhof"
                  },
                  "scopes": [
                    "day.view",
                    "booking.edit"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Betrieb, Schlüssel und Rechte",
          "url": "https://docs.ski4.me/referenz/whoami/#betrieb-schlüssel-und-rechte"
        }
      }
    },
    "/api/ext/v1/bookings": {
      "get": {
        "tags": [
          "Buchungen"
        ],
        "operationId": "get-bookings",
        "summary": "Buchungen eines Zeitraums",
        "description": "Der Zeitraum bezieht sich auf den Anreisetag und nicht auf das Buchungsdatum. Eine Freitextsuche gibt es hier nicht.\n\nBraucht das Recht `booking.view` am Schlüssel.",
        "x-required-permission": "booking.view",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 200
            },
            "example": "confirmed,paid"
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "example": "2026-12-27"
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "example": "2026-12-31"
          },
          {
            "name": "accommodation",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "type": "integer",
              "minimum": 1,
              "maximum": 500
            }
          },
          {
            "name": "perPage",
            "in": "query",
            "required": false,
            "schema": {
              "default": 25,
              "type": "integer",
              "minimum": 1,
              "maximum": 100
            },
            "example": 25
          }
        ],
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "bookings": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "ref": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "source": {
                            "type": "string"
                          },
                          "locale": {
                            "type": "string"
                          },
                          "guestName": {
                            "type": "string"
                          },
                          "stay": {
                            "type": "object",
                            "properties": {
                              "arrivalOn": {
                                "type": "string"
                              },
                              "departureOn": {
                                "type": "string"
                              },
                              "rentalFrom": {
                                "type": "string"
                              },
                              "rentalDays": {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              "pickupAtDepot": {
                                "type": "boolean"
                              },
                              "accommodation": {
                                "type": "object",
                                "properties": {
                                  "id": {
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "minimum": -9007199254740991,
                                        "maximum": 9007199254740991
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "name": {
                                    "type": "string"
                                  },
                                  "street": {
                                    "type": "string"
                                  },
                                  "zip": {
                                    "type": "string"
                                  },
                                  "city": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "id",
                                  "name",
                                  "street",
                                  "zip",
                                  "city"
                                ],
                                "additionalProperties": {}
                              },
                              "rooms": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              }
                            },
                            "required": [
                              "arrivalOn",
                              "departureOn",
                              "rentalFrom",
                              "rentalDays",
                              "pickupAtDepot",
                              "accommodation",
                              "rooms"
                            ],
                            "additionalProperties": {}
                          },
                          "persons": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "totals": {
                            "type": "object",
                            "properties": {
                              "totalCents": {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              "depositCents": {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              "vatCents": {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              "payableCents": {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              "currency": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "totalCents",
                              "depositCents",
                              "vatCents",
                              "payableCents",
                              "currency"
                            ],
                            "additionalProperties": {}
                          },
                          "createdAt": {
                            "type": "string"
                          },
                          "confirmedAt": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "cancelledAt": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "purged": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "ref",
                          "status",
                          "source",
                          "locale",
                          "guestName",
                          "stay",
                          "persons",
                          "totals",
                          "createdAt",
                          "confirmedAt",
                          "cancelledAt",
                          "purged"
                        ],
                        "additionalProperties": {}
                      }
                    },
                    "page": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "perPage": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "total": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "pages": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    }
                  },
                  "required": [
                    "bookings",
                    "page",
                    "perPage",
                    "total",
                    "pages"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "bookings": [
                    {
                      "ref": "SB-261114-WWNP",
                      "status": "confirmed",
                      "source": "web",
                      "locale": "de",
                      "guestName": "Martin Berger",
                      "stay": {
                        "arrivalOn": "2026-12-27",
                        "departureOn": "2027-01-01",
                        "rentalFrom": "2026-12-27",
                        "rentalDays": 6,
                        "pickupAtDepot": false,
                        "accommodation": {
                          "id": 2,
                          "name": "Hotel Alpenhof",
                          "street": "Dorfstraße 12",
                          "zip": "5999",
                          "city": "Bergdorf"
                        },
                        "rooms": []
                      },
                      "persons": 3,
                      "totals": {
                        "totalCents": 58500,
                        "depositCents": 0,
                        "vatCents": 6500,
                        "payableCents": 58500,
                        "currency": "EUR"
                      },
                      "createdAt": "2026-11-14T18:21:08.900Z",
                      "confirmedAt": "2026-11-14T18:22:44.270Z",
                      "cancelledAt": null,
                      "absentAt": null,
                      "purged": false
                    }
                  ],
                  "page": 1,
                  "perPage": 25,
                  "total": 1,
                  "pages": 1
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `booking.view`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Buchungen auflisten",
          "url": "https://docs.ski4.me/referenz/buchungen/#buchungen-auflisten"
        }
      },
      "post": {
        "tags": [
          "Buchungen"
        ],
        "operationId": "post-bookings",
        "summary": "Eine Buchung anlegen",
        "description": "Ohne Zahlung, genau wie das Büro sie im Portal anlegt: der Betrieb rechnet selbst ab. Gerechnet wird aus den Positionen; Beträge im Rumpf werden verworfen. Die Buchung ist sofort bestätigt, und die beiden Aufträge entstehen mit.\n\nBraucht das Recht `booking.create` am Schlüssel.\n\nJede Position trägt eine eigene `id`, etwa `p1`, `p2`: über sie ordnet der Server die berechneten Zeilen den Personen zu. Angelegt wird der Verleih, also Positionen mit `kind: \"rental\"`.",
        "x-required-permission": "booking.create",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "items": {
                    "minItems": 1,
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "oneOf": [
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "rental"
                            },
                            "id": {
                              "type": "string",
                              "maxLength": 40
                            },
                            "from": {
                              "type": "string",
                              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                            },
                            "days": {
                              "type": "integer",
                              "minimum": 1,
                              "maximum": 60
                            },
                            "person": {
                              "type": "object",
                              "properties": {
                                "firstName": {
                                  "default": "",
                                  "type": "string",
                                  "maxLength": 60
                                },
                                "lastName": {
                                  "default": "",
                                  "type": "string",
                                  "maxLength": 60
                                },
                                "age": {
                                  "default": null,
                                  "anyOf": [
                                    {
                                      "type": "integer",
                                      "minimum": 1,
                                      "maximum": 110
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "ageGroup": {
                                  "default": null,
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "enum": [
                                        "child",
                                        "youth",
                                        "adult",
                                        "senior"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "heightCm": {
                                  "default": null,
                                  "anyOf": [
                                    {
                                      "type": "integer",
                                      "minimum": 60,
                                      "maximum": 230
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "weightKg": {
                                  "default": null,
                                  "anyOf": [
                                    {
                                      "type": "integer",
                                      "minimum": 10,
                                      "maximum": 250
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "shoeSize": {
                                  "default": null,
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "maxLength": 10
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "headSize": {
                                  "default": null,
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "maxLength": 10
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "skierType": {
                                  "default": null,
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "enum": [
                                        "I",
                                        "II",
                                        "III"
                                      ]
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "ownBoots": {
                                  "default": false,
                                  "type": "boolean"
                                },
                                "bootSoleMm": {
                                  "default": null,
                                  "anyOf": [
                                    {
                                      "type": "integer",
                                      "minimum": 200,
                                      "maximum": 400
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "wideFeet": {
                                  "default": false,
                                  "type": "boolean"
                                }
                              }
                            },
                            "selections": {
                              "default": [],
                              "maxItems": 10,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "categoryCode": {
                                    "type": "string",
                                    "maxLength": 40
                                  },
                                  "modelCode": {
                                    "type": "string",
                                    "maxLength": 40
                                  }
                                },
                                "required": [
                                  "categoryCode",
                                  "modelCode"
                                ]
                              }
                            },
                            "poles": {
                              "default": false,
                              "type": "boolean"
                            },
                            "damageWaiver": {
                              "default": false,
                              "type": "boolean"
                            },
                            "lateReturn": {
                              "default": false,
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "kind",
                            "from",
                            "days",
                            "person"
                          ]
                        },
                        {
                          "type": "object",
                          "properties": {
                            "kind": {
                              "type": "string",
                              "const": "course"
                            },
                            "id": {
                              "type": "string",
                              "maxLength": 40
                            },
                            "courseId": {
                              "type": "string",
                              "maxLength": 20
                            },
                            "courseName": {
                              "default": "",
                              "type": "string",
                              "maxLength": 120
                            },
                            "variantId": {
                              "type": "string",
                              "maxLength": 20
                            },
                            "date": {
                              "type": "string",
                              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                            },
                            "persons": {
                              "default": [],
                              "maxItems": 12,
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "firstName": {
                                    "default": "",
                                    "type": "string",
                                    "maxLength": 60
                                  },
                                  "lastName": {
                                    "default": "",
                                    "type": "string",
                                    "maxLength": 60
                                  },
                                  "age": {
                                    "default": null,
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "minimum": 1,
                                        "maximum": 110
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "ageGroup": {
                                    "default": null,
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "enum": [
                                          "child",
                                          "youth",
                                          "adult",
                                          "senior"
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "heightCm": {
                                    "default": null,
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "minimum": 60,
                                        "maximum": 230
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "weightKg": {
                                    "default": null,
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "minimum": 10,
                                        "maximum": 250
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "shoeSize": {
                                    "default": null,
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 10
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "headSize": {
                                    "default": null,
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "maxLength": 10
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "skierType": {
                                    "default": null,
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "enum": [
                                          "I",
                                          "II",
                                          "III"
                                        ]
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "ownBoots": {
                                    "default": false,
                                    "type": "boolean"
                                  },
                                  "bootSoleMm": {
                                    "default": null,
                                    "anyOf": [
                                      {
                                        "type": "integer",
                                        "minimum": 200,
                                        "maximum": 400
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ]
                                  },
                                  "wideFeet": {
                                    "default": false,
                                    "type": "boolean"
                                  }
                                }
                              }
                            },
                            "skillId": {
                              "default": null,
                              "anyOf": [
                                {
                                  "type": "string",
                                  "maxLength": 10
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "meetingPointId": {
                              "default": null,
                              "anyOf": [
                                {
                                  "type": "string",
                                  "maxLength": 10
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "language": {
                              "default": "de",
                              "type": "string",
                              "maxLength": 5
                            }
                          },
                          "required": [
                            "kind",
                            "courseId",
                            "variantId",
                            "date"
                          ]
                        }
                      ]
                    }
                  },
                  "locale": {
                    "type": "string",
                    "maxLength": 5
                  },
                  "customer": {
                    "type": "object",
                    "properties": {
                      "firstName": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 60
                      },
                      "lastName": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 60
                      },
                      "email": {
                        "anyOf": [
                          {
                            "type": "string",
                            "maxLength": 160,
                            "format": "email",
                            "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
                          },
                          {
                            "type": "string",
                            "const": ""
                          }
                        ]
                      },
                      "phone": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "street": {
                        "type": "string",
                        "maxLength": 120
                      },
                      "zip": {
                        "type": "string",
                        "maxLength": 12
                      },
                      "city": {
                        "type": "string",
                        "maxLength": 80
                      },
                      "country": {
                        "default": "AT",
                        "type": "string",
                        "minLength": 2,
                        "maxLength": 2
                      },
                      "note": {
                        "type": "string",
                        "maxLength": 800
                      }
                    },
                    "required": [
                      "firstName",
                      "lastName"
                    ]
                  },
                  "stay": {
                    "type": "object",
                    "properties": {
                      "accommodationId": {
                        "default": null,
                        "anyOf": [
                          {
                            "type": "integer",
                            "exclusiveMinimum": 0,
                            "maximum": 9007199254740991
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "pickupAtDepot": {
                        "default": false,
                        "type": "boolean"
                      },
                      "arrivalOn": {
                        "type": "string",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                      },
                      "departureOn": {
                        "type": "string",
                        "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                      },
                      "rooms": {
                        "default": [],
                        "maxItems": 12,
                        "type": "array",
                        "items": {
                          "type": "string",
                          "maxLength": 20
                        }
                      }
                    },
                    "required": [
                      "arrivalOn",
                      "departureOn"
                    ]
                  },
                  "source": {
                    "default": "admin",
                    "type": "string",
                    "enum": [
                      "phone",
                      "admin"
                    ]
                  }
                },
                "required": [
                  "items",
                  "customer",
                  "stay"
                ]
              },
              "example": {
                "items": [
                  {
                    "kind": "rental",
                    "id": "p1",
                    "from": "2026-12-27",
                    "days": 6,
                    "person": {
                      "firstName": "Sophie",
                      "lastName": "Lang",
                      "age": 33,
                      "heightCm": 170,
                      "weightKg": 64,
                      "shoeSize": "39",
                      "skierType": "II"
                    },
                    "selections": [
                      {
                        "categoryCode": "snowboard",
                        "modelCode": "snowboard-comfort"
                      },
                      {
                        "categoryCode": "softboots",
                        "modelCode": "softboots"
                      }
                    ],
                    "poles": false,
                    "damageWaiver": false
                  },
                  {
                    "kind": "rental",
                    "id": "p2",
                    "from": "2026-12-27",
                    "days": 6,
                    "person": {
                      "firstName": "Tom",
                      "lastName": "Lang",
                      "age": 35,
                      "heightCm": 185,
                      "weightKg": 88,
                      "shoeSize": "45",
                      "skierType": "III"
                    },
                    "selections": [
                      {
                        "categoryCode": "ski",
                        "modelCode": "ski-superior"
                      },
                      {
                        "categoryCode": "skiboots",
                        "modelCode": "skiboots-prime"
                      }
                    ],
                    "poles": true,
                    "damageWaiver": true
                  }
                ],
                "locale": "de",
                "customer": {
                  "firstName": "Sophie",
                  "lastName": "Lang",
                  "email": "sophie.lang@example.org",
                  "phone": "+43 000 000003",
                  "country": "AT",
                  "note": "Am Tresen gebucht, Lieferung heute."
                },
                "stay": {
                  "accommodationId": 3,
                  "arrivalOn": "2026-12-27",
                  "departureOn": "2027-01-01",
                  "rooms": [
                    "3"
                  ]
                },
                "source": "admin"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "ref": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "const": "confirmed"
                    },
                    "totalCents": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "payableCents": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "sealCode": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "ref",
                    "status",
                    "totalCents",
                    "payableCents",
                    "sealCode"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "ref": "SB-261227-ZA22",
                  "status": "confirmed",
                  "totalCents": 42300,
                  "payableCents": 42300,
                  "sealCode": "EB8D3EHMYU"
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `booking.create`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Eine Buchung anlegen",
          "url": "https://docs.ski4.me/referenz/buchungen/#eine-buchung-anlegen"
        }
      }
    },
    "/api/ext/v1/bookings/{ref}": {
      "get": {
        "tags": [
          "Buchungen"
        ],
        "operationId": "get-bookings-by-ref",
        "summary": "Eine Buchung mit allem",
        "description": "Nach dem Löschlauf steht `customer` auf null und `purged` auf true. Das ist kein Fehler, sondern die Löschfrist.\n\nBraucht das Recht `booking.view` am Schlüssel.",
        "x-required-permission": "booking.view",
        "parameters": [
          {
            "name": "ref",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Die Buchungsnummer, etwa SB-4K7Q.",
            "example": "SB-261114-WWNP"
          }
        ],
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "ref": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "source": {
                      "type": "string"
                    },
                    "locale": {
                      "type": "string"
                    },
                    "guestName": {
                      "type": "string"
                    },
                    "stay": {
                      "type": "object",
                      "properties": {
                        "arrivalOn": {
                          "type": "string"
                        },
                        "departureOn": {
                          "type": "string"
                        },
                        "rentalFrom": {
                          "type": "string"
                        },
                        "rentalDays": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "pickupAtDepot": {
                          "type": "boolean"
                        },
                        "accommodation": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": -9007199254740991,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "name": {
                              "type": "string"
                            },
                            "street": {
                              "type": "string"
                            },
                            "zip": {
                              "type": "string"
                            },
                            "city": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "name",
                            "street",
                            "zip",
                            "city"
                          ],
                          "additionalProperties": {}
                        },
                        "rooms": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        }
                      },
                      "required": [
                        "arrivalOn",
                        "departureOn",
                        "rentalFrom",
                        "rentalDays",
                        "pickupAtDepot",
                        "accommodation",
                        "rooms"
                      ],
                      "additionalProperties": {}
                    },
                    "persons": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "totals": {
                      "type": "object",
                      "properties": {
                        "totalCents": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "depositCents": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "vatCents": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "payableCents": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "currency": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "totalCents",
                        "depositCents",
                        "vatCents",
                        "payableCents",
                        "currency"
                      ],
                      "additionalProperties": {}
                    },
                    "createdAt": {
                      "type": "string"
                    },
                    "confirmedAt": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "cancelledAt": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "purged": {
                      "type": "boolean"
                    },
                    "customer": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "firstName": {
                              "type": "string"
                            },
                            "lastName": {
                              "type": "string"
                            },
                            "email": {
                              "type": "string"
                            },
                            "phone": {
                              "type": "string"
                            },
                            "street": {
                              "type": "string"
                            },
                            "zip": {
                              "type": "string"
                            },
                            "city": {
                              "type": "string"
                            },
                            "note": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "firstName",
                            "lastName",
                            "email",
                            "phone",
                            "street",
                            "zip",
                            "city",
                            "note"
                          ],
                          "additionalProperties": {}
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "personDetails": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "sortOrder": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "displayHint": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "envelope": {},
                          "bslSource": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "bslMeasuredMm": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "zSet": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "zSetBy": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "zSetAt": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "id",
                          "sortOrder",
                          "displayHint",
                          "envelope",
                          "bslSource",
                          "bslMeasuredMm",
                          "zSet",
                          "zSetBy",
                          "zSetAt"
                        ],
                        "additionalProperties": {}
                      }
                    },
                    "lines": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "personId": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "kind": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "detail": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "days": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "amountCents": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "vatPercent": {
                            "type": [
                              "number",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "id",
                          "personId",
                          "kind",
                          "label",
                          "detail",
                          "days",
                          "amountCents",
                          "vatPercent"
                        ],
                        "additionalProperties": {}
                      }
                    },
                    "jobs": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "kind": {
                            "type": "string"
                          },
                          "onDate": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "doneAt": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "doneBy": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "doneOnDate": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "skipReason": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "note": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "id",
                          "kind",
                          "onDate",
                          "status",
                          "doneAt",
                          "doneBy",
                          "doneOnDate",
                          "skipReason",
                          "note"
                        ],
                        "additionalProperties": {}
                      }
                    },
                    "payments": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "provider": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "amountCents": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "currency": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "provider",
                          "status",
                          "amountCents",
                          "currency"
                        ],
                        "additionalProperties": {}
                      }
                    },
                    "sealCode": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "ref",
                    "status",
                    "source",
                    "locale",
                    "guestName",
                    "stay",
                    "persons",
                    "totals",
                    "createdAt",
                    "confirmedAt",
                    "cancelledAt",
                    "purged",
                    "customer",
                    "personDetails",
                    "lines",
                    "jobs",
                    "payments",
                    "sealCode"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "ref": "SB-261114-WWNP",
                  "status": "confirmed",
                  "source": "web",
                  "locale": "de",
                  "guestName": "Martin Berger",
                  "stay": {
                    "arrivalOn": "2026-12-27",
                    "departureOn": "2027-01-01",
                    "rentalFrom": "2026-12-27",
                    "rentalDays": 6,
                    "pickupAtDepot": false,
                    "accommodation": {
                      "id": 2,
                      "name": "Hotel Alpenhof",
                      "street": "Dorfstraße 12",
                      "zip": "5999",
                      "city": "Bergdorf"
                    },
                    "rooms": []
                  },
                  "persons": 3,
                  "totals": {
                    "totalCents": 58500,
                    "depositCents": 0,
                    "vatCents": 6500,
                    "payableCents": 58500,
                    "currency": "EUR"
                  },
                  "createdAt": "2026-11-14T18:21:08.900Z",
                  "confirmedAt": "2026-11-14T18:22:44.270Z",
                  "cancelledAt": null,
                  "absentAt": null,
                  "purged": false,
                  "customer": {
                    "firstName": "Martin",
                    "lastName": "Berger",
                    "email": "martin.berger@example.org",
                    "phone": "+49 000 0000002",
                    "street": "Lindenweg 7",
                    "zip": "80331",
                    "city": "München",
                    "note": "Anreise am späten Nachmittag."
                  },
                  "personDetails": [
                    {
                      "id": 3,
                      "sortOrder": 0,
                      "displayHint": "Martin B.",
                      "envelope": {
                        "firstName": "Martin",
                        "lastName": "Berger",
                        "age": 41,
                        "ageGroup": null,
                        "heightCm": 182,
                        "weightKg": 84,
                        "shoeSize": "44",
                        "headSize": null,
                        "skierType": "II",
                        "ownBoots": false,
                        "bootSoleMm": null,
                        "wideFeet": false,
                        "bslMm": 330,
                        "skierCode": "M",
                        "zRows": [
                          {
                            "fromMm": 291,
                            "toMm": 310,
                            "z": 7,
                            "estimated": false
                          },
                          {
                            "fromMm": 311,
                            "toMm": 330,
                            "z": 6.5,
                            "estimated": true
                          },
                          {
                            "fromMm": 331,
                            "toMm": 350,
                            "z": 6,
                            "estimated": false
                          }
                        ]
                      },
                      "bslSource": "mietschuh",
                      "bslMeasuredMm": null,
                      "zSet": null,
                      "zSetBy": null,
                      "zSetAt": null
                    },
                    {
                      "id": 4,
                      "sortOrder": 1,
                      "displayHint": "Julia B.",
                      "envelope": {
                        "firstName": "Julia",
                        "lastName": "Berger",
                        "age": 38,
                        "ageGroup": null,
                        "heightCm": 168,
                        "weightKg": 62,
                        "shoeSize": "38.5",
                        "headSize": null,
                        "skierType": "II",
                        "ownBoots": false,
                        "bootSoleMm": null,
                        "wideFeet": false,
                        "bslMm": 293,
                        "skierCode": "K",
                        "zRows": [
                          {
                            "fromMm": 271,
                            "toMm": 290,
                            "z": 5.5,
                            "estimated": false
                          },
                          {
                            "fromMm": 291,
                            "toMm": 310,
                            "z": 5,
                            "estimated": true
                          },
                          {
                            "fromMm": 311,
                            "toMm": 330,
                            "z": 4.5,
                            "estimated": false
                          }
                        ]
                      },
                      "bslSource": "mietschuh",
                      "bslMeasuredMm": null,
                      "zSet": null,
                      "zSetBy": null,
                      "zSetAt": null
                    },
                    {
                      "id": 5,
                      "sortOrder": 2,
                      "displayHint": "Leon B.",
                      "envelope": {
                        "firstName": "Leon",
                        "lastName": "Berger",
                        "age": 11,
                        "ageGroup": null,
                        "heightCm": 146,
                        "weightKg": 38,
                        "shoeSize": "36",
                        "headSize": "54",
                        "skierType": "I",
                        "ownBoots": false,
                        "bootSoleMm": null,
                        "wideFeet": false,
                        "bslMm": 277,
                        "skierCode": "G",
                        "zRows": [
                          {
                            "fromMm": 251,
                            "toMm": 270,
                            "z": 3,
                            "estimated": false
                          },
                          {
                            "fromMm": 271,
                            "toMm": 290,
                            "z": 2.75,
                            "estimated": true
                          },
                          {
                            "fromMm": 291,
                            "toMm": 310,
                            "z": 2.5,
                            "estimated": false
                          }
                        ]
                      },
                      "bslSource": "mietschuh",
                      "bslMeasuredMm": null,
                      "zSet": null,
                      "zSetBy": null,
                      "zSetAt": null
                    }
                  ],
                  "lines": [
                    {
                      "id": 5,
                      "personId": 3,
                      "kind": "equipment",
                      "label": "Ski Comfort",
                      "detail": "6 Tage",
                      "days": 6,
                      "amountCents": 11400,
                      "vatPercent": 20
                    },
                    {
                      "id": 6,
                      "personId": 3,
                      "kind": "equipment",
                      "label": "Skischuhe Comfort",
                      "detail": "6 Tage",
                      "days": 6,
                      "amountCents": 4500,
                      "vatPercent": 20
                    },
                    {
                      "id": 7,
                      "personId": 3,
                      "kind": "poles",
                      "label": "Skistöcke",
                      "detail": "inklusive",
                      "days": 6,
                      "amountCents": 0,
                      "vatPercent": 20
                    },
                    {
                      "id": 8,
                      "personId": 4,
                      "kind": "equipment",
                      "label": "Ski Comfort",
                      "detail": "6 Tage",
                      "days": 6,
                      "amountCents": 11400,
                      "vatPercent": 20
                    },
                    {
                      "id": 9,
                      "personId": 4,
                      "kind": "equipment",
                      "label": "Skischuhe Comfort",
                      "detail": "6 Tage",
                      "days": 6,
                      "amountCents": 4500,
                      "vatPercent": 20
                    },
                    {
                      "id": 10,
                      "personId": 4,
                      "kind": "poles",
                      "label": "Skistöcke",
                      "detail": "inklusive",
                      "days": 6,
                      "amountCents": 0,
                      "vatPercent": 20
                    },
                    {
                      "id": 11,
                      "personId": 5,
                      "kind": "equipment",
                      "label": "Ski Comfort",
                      "detail": "6 Tage",
                      "days": 6,
                      "amountCents": 5200,
                      "vatPercent": 20
                    },
                    {
                      "id": 12,
                      "personId": 5,
                      "kind": "equipment",
                      "label": "Skischuhe Comfort",
                      "detail": "6 Tage",
                      "days": 6,
                      "amountCents": 2000,
                      "vatPercent": 20
                    },
                    {
                      "id": 13,
                      "personId": 5,
                      "kind": "equipment",
                      "label": "Helm",
                      "detail": "6 Tage · Kinder bis 12 gratis",
                      "days": 6,
                      "amountCents": 0,
                      "vatPercent": 20
                    },
                    {
                      "id": 14,
                      "personId": null,
                      "kind": "course",
                      "label": "Kinderkurs, 3 Tage",
                      "detail": "3 Tage · 2.5 h · ab 10:00 Uhr",
                      "days": 3,
                      "amountCents": 19500,
                      "vatPercent": null
                    }
                  ],
                  "jobs": [
                    {
                      "id": 3,
                      "kind": "delivery",
                      "onDate": "2026-12-27",
                      "status": "open",
                      "doneAt": null,
                      "doneBy": null,
                      "doneOnDate": null,
                      "skipReason": null,
                      "note": null
                    },
                    {
                      "id": 4,
                      "kind": "pickup",
                      "onDate": "2027-01-01",
                      "status": "open",
                      "doneAt": null,
                      "doneBy": null,
                      "doneOnDate": null,
                      "skipReason": null,
                      "note": null
                    }
                  ],
                  "payments": [
                    {
                      "provider": "demo",
                      "status": "paid",
                      "amountCents": 58500,
                      "currency": "EUR",
                      "cardBrand": "visa",
                      "authorizedAt": "2026-11-14T18:22:44.270Z",
                      "payoutRef": null,
                      "payoutOn": null,
                      "feeCents": 0
                    }
                  ],
                  "sealCode": "WJ58JVBE38"
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `booking.view`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Diesen Eintrag gibt es nicht.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/NotFound"
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Eine Buchung lesen",
          "url": "https://docs.ski4.me/referenz/buchungen/#eine-buchung-lesen"
        }
      },
      "patch": {
        "tags": [
          "Buchungen"
        ],
        "operationId": "patch-bookings-by-ref",
        "summary": "Aufenthalt, Unterkunft, Zimmer und Notizen ändern",
        "description": "Beträge ändert dieser Weg nicht. Wer den Preis einer bezahlten Buchung korrigieren will, storniert und legt neu an. Ändert sich ein Datum, wandern die Aufträge mit.\n\nBraucht das Recht `booking.edit` am Schlüssel.",
        "x-required-permission": "booking.edit",
        "parameters": [
          {
            "name": "ref",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Die Buchungsnummer, etwa SB-4K7Q.",
            "example": "SB-261114-WWNP"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "arrivalOn": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "departureOn": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  },
                  "accommodationId": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "exclusiveMinimum": 0,
                        "maximum": 9007199254740991
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "pickupAtDepot": {
                    "type": "boolean"
                  },
                  "rooms": {
                    "maxItems": 12,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "maxLength": 20
                    }
                  },
                  "internalNote": {
                    "type": "string",
                    "maxLength": 2000
                  },
                  "guestNote": {
                    "type": "string",
                    "maxLength": 800
                  }
                }
              },
              "example": {
                "rooms": [
                  "204",
                  "205"
                ],
                "guestNote": "Kinderzimmer ist 205."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "ref": {
                      "type": "string"
                    },
                    "changed": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "ref",
                    "changed"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "ref": "SB-261114-WWNP",
                  "changed": [
                    "rooms",
                    "guestNote"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `booking.edit`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Diesen Eintrag gibt es nicht.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/NotFound"
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Eine Buchung ändern",
          "url": "https://docs.ski4.me/referenz/buchungen/#eine-buchung-ändern"
        }
      }
    },
    "/api/ext/v1/bookings/{ref}/cancel-proposal": {
      "get": {
        "tags": [
          "Buchungen"
        ],
        "operationId": "get-bookings-by-ref-cancel-proposal",
        "summary": "Vorschlag für ein Storno nach der Staffel",
        "description": "Tage bis zum ersten Miettag, die greifende Stufe der Staffel und die Beträge. Ab dem ersten Miettag sind es immer 100 Prozent vom Mietanteil; die Kaution geht immer ganz zurück.\n\nBraucht das Recht `booking.cancel` am Schlüssel.",
        "x-required-permission": "booking.cancel",
        "parameters": [
          {
            "name": "ref",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Die Buchungsnummer, etwa SB-4K7Q.",
            "example": "SB-261112-WDZH"
          }
        ],
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "daysBefore": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "feePercent": {
                      "type": "number"
                    },
                    "rentalCents": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "feeCents": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "rentalRefundCents": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "depositRefundCents": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "courseCents": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "totalRefundCents": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "basis": {
                      "type": "string",
                      "enum": [
                        "staffel",
                        "ab_anreise",
                        "keine_staffel"
                      ]
                    }
                  },
                  "required": [
                    "daysBefore",
                    "feePercent",
                    "rentalCents",
                    "feeCents",
                    "rentalRefundCents",
                    "depositRefundCents",
                    "courseCents",
                    "totalRefundCents",
                    "basis"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "daysBefore": 37,
                  "feePercent": 25,
                  "rentalCents": 21000,
                  "feeCents": 5250,
                  "rentalRefundCents": 15750,
                  "depositRefundCents": 0,
                  "courseCents": 7900,
                  "totalRefundCents": 15750,
                  "basis": "staffel"
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `booking.cancel`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Diesen Eintrag gibt es nicht.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/NotFound"
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Stornovorschlag lesen",
          "url": "https://docs.ski4.me/referenz/buchungen/#stornovorschlag-lesen"
        }
      }
    },
    "/api/ext/v1/bookings/{ref}/cancel": {
      "post": {
        "tags": [
          "Buchungen"
        ],
        "operationId": "post-bookings-by-ref-cancel",
        "summary": "Eine Buchung stornieren, ohne Geld zu bewegen",
        "description": "`rentalRefundCents` ist, was vom Mietanteil zurückgeht, zwischen null und dem Mietanteil; die Kaution kommt immer ganz dazu. Ein Schlüssel bewegt kein Geld: die Rückzahlung steht danach offen an der Buchung, und der Admin stößt sie im Portal an. Der Gast bekommt eine Stornobestätigung per Mail.\n\nBraucht das Recht `booking.cancel` am Schlüssel.",
        "x-required-permission": "booking.cancel",
        "parameters": [
          {
            "name": "ref",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Die Buchungsnummer, etwa SB-4K7Q.",
            "example": "SB-261112-WDZH"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "rentalRefundCents": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  "reason": {
                    "type": "string",
                    "minLength": 3,
                    "maxLength": 400
                  }
                },
                "required": [
                  "rentalRefundCents",
                  "reason"
                ]
              },
              "example": {
                "rentalRefundCents": 15750,
                "reason": "Gast hat telefonisch abgesagt."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "ref": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "const": "cancelled"
                    },
                    "feeCents": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "rentalRefundCents": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "depositCents": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "guestMailed": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "ref",
                    "status",
                    "feeCents",
                    "rentalRefundCents",
                    "depositCents",
                    "guestMailed"
                  ],
                  "additionalProperties": false
                },
                "example": {
                  "ref": "SB-261112-WDZH",
                  "status": "cancelled",
                  "feeCents": 5250,
                  "rentalRefundCents": 15750,
                  "depositCents": 0,
                  "guestMailed": true
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `booking.cancel`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Diesen Eintrag gibt es nicht.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/NotFound"
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Eine Buchung stornieren",
          "url": "https://docs.ski4.me/referenz/buchungen/#eine-buchung-stornieren"
        }
      }
    },
    "/api/ext/v1/days/{date}": {
      "get": {
        "tags": [
          "Tour"
        ],
        "operationId": "get-days-by-date",
        "summary": "Aufträge eines Tages mit Zustellstatus",
        "description": "Eine flache Liste in der Reihenfolge der Tour. Kein Lieferfenster: es gibt keine Uhrzeit, zu der geliefert wird, und deshalb auch kein Feld dafür.\n\nBraucht das Recht `day.view` am Schlüssel.",
        "x-required-permission": "day.view",
        "parameters": [
          {
            "name": "date",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Ein Tag als JJJJ-MM-TT.",
            "example": "2026-12-27"
          }
        ],
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "date": {
                      "type": "string"
                    },
                    "jobs": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "kind": {
                            "type": "string",
                            "enum": [
                              "delivery",
                              "pickup"
                            ]
                          },
                          "onDate": {
                            "type": "string"
                          },
                          "sortOrder": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "open",
                              "done",
                              "skipped"
                            ]
                          },
                          "accommodation": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": -9007199254740991,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "name": {
                                "type": "string"
                              },
                              "street": {
                                "type": "string"
                              },
                              "zip": {
                                "type": "string"
                              },
                              "city": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "id",
                              "name",
                              "street",
                              "zip",
                              "city"
                            ],
                            "additionalProperties": {}
                          },
                          "booking": {
                            "type": "object",
                            "properties": {
                              "ref": {
                                "type": "string"
                              },
                              "status": {
                                "type": "string"
                              },
                              "guestName": {
                                "type": "string"
                              },
                              "phone": {
                                "type": [
                                  "string",
                                  "null"
                                ]
                              },
                              "rooms": {
                                "type": "array",
                                "items": {
                                  "type": "string"
                                }
                              },
                              "persons": {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              "pickupAtDepot": {
                                "type": "boolean"
                              }
                            },
                            "required": [
                              "ref",
                              "status",
                              "guestName",
                              "phone",
                              "rooms",
                              "persons",
                              "pickupAtDepot"
                            ],
                            "additionalProperties": {}
                          },
                          "note": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "skipReason": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "doneAt": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "doneBy": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "doneOnDate": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "earlyDone": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "id",
                          "kind",
                          "onDate",
                          "sortOrder",
                          "status",
                          "accommodation",
                          "booking",
                          "note",
                          "skipReason",
                          "doneAt",
                          "doneBy",
                          "doneOnDate",
                          "earlyDone"
                        ],
                        "additionalProperties": {}
                      }
                    },
                    "counts": {
                      "type": "object",
                      "properties": {
                        "delivery": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "pickup": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "open": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "done": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        },
                        "skipped": {
                          "type": "integer",
                          "minimum": -9007199254740991,
                          "maximum": 9007199254740991
                        }
                      },
                      "required": [
                        "delivery",
                        "pickup",
                        "open",
                        "done",
                        "skipped"
                      ],
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "date",
                    "jobs",
                    "counts"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "date": "2026-12-27",
                  "jobs": [
                    {
                      "id": 3,
                      "kind": "delivery",
                      "onDate": "2026-12-27",
                      "sortOrder": null,
                      "status": "open",
                      "accommodation": {
                        "id": 2,
                        "name": "Hotel Alpenhof",
                        "street": "Dorfstraße 12",
                        "zip": "5999",
                        "city": "Bergdorf"
                      },
                      "booking": {
                        "ref": "SB-261114-WWNP",
                        "status": "confirmed",
                        "guestName": "Martin Berger",
                        "phone": "+49 000 0000002",
                        "rooms": [
                          "204",
                          "205"
                        ],
                        "persons": 3,
                        "pickupAtDepot": false
                      },
                      "note": null,
                      "skipReason": null,
                      "doneAt": null,
                      "doneBy": null,
                      "doneOnDate": null,
                      "earlyDone": false
                    },
                    {
                      "id": 5,
                      "kind": "delivery",
                      "onDate": "2026-12-27",
                      "sortOrder": null,
                      "status": "open",
                      "accommodation": {
                        "id": 3,
                        "name": "Pension Sonnblick",
                        "street": "Sonnweg 4",
                        "zip": "5999",
                        "city": "Bergdorf"
                      },
                      "booking": {
                        "ref": "SB-261227-ZA22",
                        "status": "confirmed",
                        "guestName": "Sophie Lang",
                        "phone": "+43 000 000003",
                        "rooms": [
                          "3"
                        ],
                        "persons": 2,
                        "pickupAtDepot": false
                      },
                      "note": null,
                      "skipReason": null,
                      "doneAt": null,
                      "doneBy": null,
                      "doneOnDate": null,
                      "earlyDone": false
                    }
                  ],
                  "counts": {
                    "delivery": 2,
                    "pickup": 0,
                    "open": 2,
                    "done": 0,
                    "skipped": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `day.view`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Diesen Eintrag gibt es nicht.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Aufträge eines Tages",
          "url": "https://docs.ski4.me/referenz/tour/#aufträge-eines-tages"
        }
      }
    },
    "/api/ext/v1/jobs/{id}": {
      "patch": {
        "tags": [
          "Tour"
        ],
        "operationId": "patch-jobs-by-id",
        "summary": "Auftrag erledigen, zurücknehmen, überspringen",
        "description": "Bei `skipped` ist `skipReason` Pflicht. Der Buchungsstatus folgt: geliefert, abgeholt, und erst wenn beide Aufträge erledigt sind, geschlossen.\n\nBraucht das Recht `job.complete` am Schlüssel.",
        "x-required-permission": "job.complete",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Die Nummer des Eintrags.",
            "example": "3"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string",
                    "enum": [
                      "open",
                      "done",
                      "skipped"
                    ]
                  },
                  "skipReason": {
                    "type": "string",
                    "maxLength": 400
                  },
                  "note": {
                    "type": "string",
                    "maxLength": 800
                  }
                }
              },
              "example": {
                "status": "done",
                "note": "Im Skiraum abgestellt, Fach 204."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "jobId": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "note": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "jobId",
                    "note"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "jobId": 3,
                  "status": "done",
                  "doneAt": "2026-12-27T08:12:46.278Z",
                  "doneBy": "Kassensystem",
                  "doneOnDate": "2026-12-27",
                  "earlyDone": false,
                  "skipReason": null,
                  "swapStatus": null,
                  "note": "Im Skiraum abgestellt, Fach 204."
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `job.complete`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Diesen Eintrag gibt es nicht.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Einen Auftrag melden",
          "url": "https://docs.ski4.me/referenz/tour/#einen-auftrag-melden"
        }
      }
    },
    "/api/ext/v1/accommodations": {
      "get": {
        "tags": [
          "Unterkünfte"
        ],
        "operationId": "get-accommodations",
        "summary": "Liste der Unterkünfte",
        "description": "Braucht das Recht `day.view` am Schlüssel.",
        "x-required-permission": "day.view",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "maxLength": 120
            },
            "example": "Dorfstraße"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "default": 100,
              "type": "integer",
              "minimum": 1,
              "maximum": 500
            },
            "example": 10
          },
          {
            "name": "includeInactive",
            "in": "query",
            "required": false,
            "schema": {
              "default": false,
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "accommodations": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "name": {
                            "type": "string"
                          },
                          "street": {
                            "type": "string"
                          },
                          "zip": {
                            "type": "string"
                          },
                          "city": {
                            "type": "string"
                          },
                          "country": {
                            "type": "string"
                          },
                          "district": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "lat": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "lng": {
                            "type": [
                              "number",
                              "null"
                            ]
                          },
                          "placeId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "contactName": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "contactPhone": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "driverNote": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "isDepot": {
                            "type": "boolean"
                          },
                          "active": {
                            "type": "boolean"
                          },
                          "bookingCount": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "street",
                          "zip",
                          "city",
                          "country",
                          "district",
                          "lat",
                          "lng",
                          "placeId",
                          "contactName",
                          "contactPhone",
                          "driverNote",
                          "isDepot",
                          "active",
                          "bookingCount"
                        ],
                        "additionalProperties": {}
                      }
                    }
                  },
                  "required": [
                    "accommodations"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "accommodations": [
                    {
                      "id": 6,
                      "name": "Gasthof Talblick",
                      "street": "Dorfstraße 30",
                      "zip": "5999",
                      "city": "Bergdorf",
                      "country": "AT",
                      "district": "Unterdorf",
                      "lat": 47.2488,
                      "lng": 13.2052,
                      "placeId": null,
                      "contactName": null,
                      "contactPhone": null,
                      "driverNote": null,
                      "isDepot": false,
                      "active": true,
                      "bookingCount": 0
                    },
                    {
                      "id": 2,
                      "name": "Hotel Alpenhof",
                      "street": "Dorfstraße 12",
                      "zip": "5999",
                      "city": "Bergdorf",
                      "country": "AT",
                      "district": "Oberdorf",
                      "lat": 47.2533,
                      "lng": 13.2071,
                      "placeId": "ChIJalpenhofBergdorf0001",
                      "contactName": "Rezeption",
                      "contactPhone": "+43 000 000010",
                      "driverNote": "Skiraum im Untergeschoss, Zugang über die Garage.",
                      "isDepot": false,
                      "active": true,
                      "bookingCount": 0
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `day.view`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Unterkünfte auflisten",
          "url": "https://docs.ski4.me/referenz/unterkuenfte/#unterkünfte-auflisten"
        }
      },
      "post": {
        "tags": [
          "Unterkünfte"
        ],
        "operationId": "post-accommodations",
        "summary": "Eine Unterkunft anlegen",
        "description": "Ist `placeId` gesetzt und schon vergeben, antwortet der Server mit 409 und nennt den vorhandenen Eintrag. Dieselbe Stelle zweimal anzulegen ist der häufigste Weg zu einer Dublette.\n\nBraucht das Recht `accommodation.edit` am Schlüssel.",
        "x-required-permission": "accommodation.edit",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "street": {
                    "default": "",
                    "type": "string",
                    "maxLength": 200
                  },
                  "zip": {
                    "default": "",
                    "type": "string",
                    "maxLength": 20
                  },
                  "city": {
                    "default": "",
                    "type": "string",
                    "maxLength": 120
                  },
                  "country": {
                    "default": "AT",
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 2
                  },
                  "district": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 120
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "lat": {
                    "anyOf": [
                      {
                        "type": "number",
                        "minimum": -90,
                        "maximum": 90
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "lng": {
                    "anyOf": [
                      {
                        "type": "number",
                        "minimum": -180,
                        "maximum": 180
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "placeId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "contactName": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 120
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "contactPhone": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 60
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "driverNote": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 500
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "isDepot": {
                    "default": false,
                    "type": "boolean"
                  }
                },
                "required": [
                  "name"
                ]
              },
              "example": {
                "name": "Hotel Alpenhof",
                "street": "Dorfstraße 12",
                "zip": "5999",
                "city": "Bergdorf",
                "country": "AT",
                "district": "Oberdorf",
                "lat": 47.2533,
                "lng": 13.2071,
                "placeId": "ChIJalpenhofBergdorf0001",
                "contactName": "Rezeption",
                "contactPhone": "+43 000 000010",
                "driverNote": "Skiraum im Untergeschoss, Zugang über die Garage."
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "name": {
                      "type": "string"
                    },
                    "street": {
                      "type": "string"
                    },
                    "zip": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "country": {
                      "type": "string"
                    },
                    "district": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "lat": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "lng": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "placeId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "contactName": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "contactPhone": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "driverNote": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "isDepot": {
                      "type": "boolean"
                    },
                    "active": {
                      "type": "boolean"
                    },
                    "bookingCount": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "street",
                    "zip",
                    "city",
                    "country",
                    "district",
                    "lat",
                    "lng",
                    "placeId",
                    "contactName",
                    "contactPhone",
                    "driverNote",
                    "isDepot",
                    "active",
                    "bookingCount"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "id": 2,
                  "name": "Hotel Alpenhof",
                  "street": "Dorfstraße 12",
                  "zip": "5999",
                  "city": "Bergdorf",
                  "country": "AT",
                  "district": "Oberdorf",
                  "lat": 47.2533,
                  "lng": 13.2071,
                  "placeId": "ChIJalpenhofBergdorf0001",
                  "contactName": "Rezeption",
                  "contactPhone": "+43 000 000010",
                  "driverNote": "Skiraum im Untergeschoss, Zugang über die Garage.",
                  "isDepot": false,
                  "active": true,
                  "bookingCount": 0
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `accommodation.edit`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Eine Unterkunft anlegen",
          "url": "https://docs.ski4.me/referenz/unterkuenfte/#eine-unterkunft-anlegen"
        }
      }
    },
    "/api/ext/v1/accommodations/{id}": {
      "get": {
        "tags": [
          "Unterkünfte"
        ],
        "operationId": "get-accommodations-by-id",
        "summary": "Eine Unterkunft",
        "description": "Braucht das Recht `day.view` am Schlüssel.",
        "x-required-permission": "day.view",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Die Nummer des Eintrags.",
            "example": "2"
          }
        ],
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "name": {
                      "type": "string"
                    },
                    "street": {
                      "type": "string"
                    },
                    "zip": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "country": {
                      "type": "string"
                    },
                    "district": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "lat": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "lng": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "placeId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "contactName": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "contactPhone": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "driverNote": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "isDepot": {
                      "type": "boolean"
                    },
                    "active": {
                      "type": "boolean"
                    },
                    "bookingCount": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "street",
                    "zip",
                    "city",
                    "country",
                    "district",
                    "lat",
                    "lng",
                    "placeId",
                    "contactName",
                    "contactPhone",
                    "driverNote",
                    "isDepot",
                    "active",
                    "bookingCount"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "id": 2,
                  "name": "Hotel Alpenhof",
                  "street": "Dorfstraße 12",
                  "zip": "5999",
                  "city": "Bergdorf",
                  "country": "AT",
                  "district": "Oberdorf",
                  "lat": 47.2533,
                  "lng": 13.2071,
                  "placeId": "ChIJalpenhofBergdorf0001",
                  "contactName": "Rezeption",
                  "contactPhone": "+43 000 000010",
                  "driverNote": "Skiraum im Untergeschoss, Zugang über die Garage.",
                  "isDepot": false,
                  "active": true,
                  "bookingCount": 0
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `day.view`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Diesen Eintrag gibt es nicht.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Eine Unterkunft lesen",
          "url": "https://docs.ski4.me/referenz/unterkuenfte/#eine-unterkunft-lesen"
        }
      },
      "patch": {
        "tags": [
          "Unterkünfte"
        ],
        "operationId": "patch-accommodations-by-id",
        "summary": "Eine Unterkunft ändern",
        "description": "Braucht das Recht `accommodation.edit` am Schlüssel.\n\nSenden Sie `street`, `zip` und `city` bei jeder Änderung mit, auch wenn sie gleich bleiben.",
        "x-required-permission": "accommodation.edit",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Die Nummer des Eintrags.",
            "example": "2"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 200
                  },
                  "street": {
                    "default": "",
                    "type": "string",
                    "maxLength": 200
                  },
                  "zip": {
                    "default": "",
                    "type": "string",
                    "maxLength": 20
                  },
                  "city": {
                    "default": "",
                    "type": "string",
                    "maxLength": 120
                  },
                  "country": {
                    "default": "AT",
                    "type": "string",
                    "minLength": 2,
                    "maxLength": 2
                  },
                  "district": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 120
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "lat": {
                    "anyOf": [
                      {
                        "type": "number",
                        "minimum": -90,
                        "maximum": 90
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "lng": {
                    "anyOf": [
                      {
                        "type": "number",
                        "minimum": -180,
                        "maximum": 180
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "placeId": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 200
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "contactName": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 120
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "contactPhone": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 60
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "driverNote": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 500
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "isDepot": {
                    "default": false,
                    "type": "boolean"
                  },
                  "active": {
                    "type": "boolean"
                  }
                }
              },
              "example": {
                "street": "Dorfstraße 12",
                "zip": "5999",
                "city": "Bergdorf",
                "contactName": "Rezeption, Frau Huber",
                "driverNote": "Skiraum im Untergeschoss, Zugang über die Garage. Schlüssel an der Rezeption."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "name": {
                      "type": "string"
                    },
                    "street": {
                      "type": "string"
                    },
                    "zip": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "country": {
                      "type": "string"
                    },
                    "district": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "lat": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "lng": {
                      "type": [
                        "number",
                        "null"
                      ]
                    },
                    "placeId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "contactName": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "contactPhone": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "driverNote": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "isDepot": {
                      "type": "boolean"
                    },
                    "active": {
                      "type": "boolean"
                    },
                    "bookingCount": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "street",
                    "zip",
                    "city",
                    "country",
                    "district",
                    "lat",
                    "lng",
                    "placeId",
                    "contactName",
                    "contactPhone",
                    "driverNote",
                    "isDepot",
                    "active",
                    "bookingCount"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "id": 2,
                  "name": "Hotel Alpenhof",
                  "street": "Dorfstraße 12",
                  "zip": "5999",
                  "city": "Bergdorf",
                  "country": "AT",
                  "district": "Oberdorf",
                  "lat": 47.2533,
                  "lng": 13.2071,
                  "placeId": "ChIJalpenhofBergdorf0001",
                  "contactName": "Rezeption, Frau Huber",
                  "contactPhone": "+43 000 000010",
                  "driverNote": "Skiraum im Untergeschoss, Zugang über die Garage. Schlüssel an der Rezeption.",
                  "isDepot": false,
                  "active": true,
                  "bookingCount": 0
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `accommodation.edit`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Diesen Eintrag gibt es nicht.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Eine Unterkunft ändern",
          "url": "https://docs.ski4.me/referenz/unterkuenfte/#eine-unterkunft-ändern"
        }
      },
      "delete": {
        "tags": [
          "Unterkünfte"
        ],
        "operationId": "delete-accommodations-by-id",
        "summary": "Eine Unterkunft entfernen",
        "description": "Hängen Buchungen daran, wird sie stillgelegt statt gelöscht (`deactivated`). Sonst verlöre die Auswertung \"welches Haus bringt wieviel\" still ihre Zuordnung.\n\nBraucht das Recht `accommodation.edit` am Schlüssel.",
        "x-required-permission": "accommodation.edit",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Die Nummer des Eintrags.",
            "example": "6"
          }
        ],
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "deactivated",
                        "deleted"
                      ]
                    }
                  },
                  "required": [
                    "status"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "status": "deleted"
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `accommodation.edit`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Diesen Eintrag gibt es nicht.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Eine Unterkunft entfernen",
          "url": "https://docs.ski4.me/referenz/unterkuenfte/#eine-unterkunft-entfernen"
        }
      }
    },
    "/api/ext/v1/settings": {
      "get": {
        "tags": [
          "Einstellungen"
        ],
        "operationId": "get-settings",
        "summary": "Einstellungen des Betriebs",
        "description": "Verschlüsselte Spalten gehen hier nicht hinaus. Statt ihrer steht in der Antwort, ob etwas hinterlegt ist: `payment_secrets_set` für den Zahlungsanbieter, `google_reviews_key_set` für den Zugang zur Places API.\n\nBraucht das Recht `day.view` am Schlüssel.",
        "x-required-permission": "day.view",
        "parameters": [],
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "settings": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "settings"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "settings": {
                    "id": 1,
                    "name": "Skiverleih Talstation",
                    "legal_name": "Skiverleih Talstation GmbH",
                    "vat_id": "ATU00000000",
                    "email": "office@skiverleih-talstation.example",
                    "phone": "+43 000 000000",
                    "whatsapp": null,
                    "depot_street": "Liftstraße 1",
                    "depot_zip": "5999",
                    "depot_city": "Bergdorf",
                    "depot_country": "AT",
                    "depot_lat": 47.2501,
                    "depot_lng": 13.2002,
                    "accommodation_required": 1,
                    "change_cutoff_time": "18:00",
                    "return_time": "18:00",
                    "late_return_time": "10:00",
                    "locales_json": "[\"de\",\"en\"]",
                    "default_locale": "de",
                    "module_courses": 1,
                    "course_provider_name": "Skischule Bergdorf",
                    "course_provider_addr": "Liftstraße 3, 5999 Bergdorf",
                    "course_provider_vat": null,
                    "course_commission_percent": 12,
                    "module_reviews": 0,
                    "module_guest_accounts": 0,
                    "payment_provider": null,
                    "payment_mode": "demo",
                    "payment_source_code": null,
                    "google_place_id": null,
                    "pii_purge_day": "07-01",
                    "pii_keep_months": 6,
                    "booking_keep_months": 12,
                    "theme_json": null,
                    "updated_at": "2026-11-10T08:00:00.000Z",
                    "warehouse_lat": 47.2501,
                    "warehouse_lng": 13.2002,
                    "course_endpoint": null,
                    "course_school_id": null,
                    "course_templates": null,
                    "season_start": "11-28",
                    "season_end": "04-18",
                    "elfsight_widget_id": null,
                    "notify_booking_new": 1,
                    "notify_guest_change": 1,
                    "notify_needs_review": 1,
                    "notify_damage_report": 1,
                    "notify_sale_paid": 1,
                    "notify_booking_absent": 1,
                    "assistant_enabled": 0,
                    "assistant_daily_limit": 100,
                    "currency": "EUR",
                    "vat_percent": 20,
                    "website_json": "{\"region\":\"Salzburg\",\"openingHours\":[{\"key\":\"daily\",\"schema\":[\"Monday\",\"Tuesday\",\"Wednesday\",\"Thursday\",\"Friday\",\"Saturday\",\"Sunday\"],\"ranges\":[{\"opens\":\"08:00\",\"closes\":\"18:00\"}]}],\"school\":{\"name\":\"Skischule Bergdorf\",\"email\":\"buero@skischule-bergdorf.example\",\"phone\":\"+43 000 000020\",\"street\":\"Liftstraße 3\",\"city\":\"5999 Bergdorf\",\"meetingPoint\":{\"lat\":47.2509,\"lng\":13.2008},\"earlyBookingPercent\":0,\"earlyBookingLeadDays\":0}}",
                    "notify_swap_request": 1,
                    "swap_lead_minutes": 90,
                    "swap_from_time": "09:00",
                    "swap_until_time": "15:30",
                    "promo_percent": null,
                    "notify_link_paid": 1,
                    "module_shop": 0,
                    "age_mode": "exact",
                    "payment_secrets_set": 0,
                    "google_reviews_key_set": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `day.view`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Einstellungen lesen",
          "url": "https://docs.ski4.me/referenz/einstellungen/#einstellungen-lesen"
        }
      },
      "patch": {
        "tags": [
          "Einstellungen"
        ],
        "operationId": "patch-settings",
        "summary": "Einstellungen ändern",
        "description": "Nur bekannte Felder; ein unbekanntes wird still verworfen. Steht gar nichts Bekanntes im Rumpf, nennt die Antwort die Felder, die es gibt.\n\nBraucht das Recht `settings.edit` am Schlüssel.",
        "x-required-permission": "settings.edit",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$schema": "https://json-schema.org/draft/2020-12/schema",
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              "example": {
                "return_time": "17:30",
                "late_return_time": "09:30"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "settings": {
                      "type": "object",
                      "propertyNames": {
                        "type": "string"
                      },
                      "additionalProperties": {}
                    }
                  },
                  "required": [
                    "settings"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "settings": {
                    "id": 1,
                    "name": "Skiverleih Talstation",
                    "legal_name": "Skiverleih Talstation GmbH",
                    "vat_id": "ATU00000000",
                    "email": "office@skiverleih-talstation.example",
                    "phone": "+43 000 000000",
                    "whatsapp": null,
                    "depot_street": "Liftstraße 1",
                    "depot_zip": "5999",
                    "depot_city": "Bergdorf",
                    "depot_country": "AT",
                    "depot_lat": 47.2501,
                    "depot_lng": 13.2002,
                    "accommodation_required": 1,
                    "change_cutoff_time": "18:00",
                    "return_time": "17:30",
                    "late_return_time": "09:30",
                    "locales_json": "[\"de\",\"en\"]",
                    "default_locale": "de",
                    "module_courses": 1,
                    "course_provider_name": "Skischule Bergdorf",
                    "course_provider_addr": "Liftstraße 3, 5999 Bergdorf",
                    "course_provider_vat": null,
                    "course_commission_percent": 12,
                    "module_reviews": 0,
                    "module_guest_accounts": 0,
                    "payment_provider": null,
                    "payment_mode": "demo",
                    "payment_source_code": null,
                    "google_place_id": null,
                    "pii_purge_day": "07-01",
                    "pii_keep_months": 6,
                    "booking_keep_months": 12,
                    "theme_json": null,
                    "updated_at": "2026-11-10T08:00:00.000Z",
                    "warehouse_lat": 47.2501,
                    "warehouse_lng": 13.2002,
                    "course_endpoint": null,
                    "course_school_id": null,
                    "course_templates": null,
                    "season_start": "11-28",
                    "season_end": "04-18",
                    "elfsight_widget_id": null,
                    "notify_booking_new": 1,
                    "notify_guest_change": 1,
                    "notify_needs_review": 1,
                    "notify_damage_report": 1,
                    "notify_sale_paid": 1,
                    "notify_booking_absent": 1,
                    "assistant_enabled": 0,
                    "assistant_daily_limit": 100,
                    "currency": "EUR",
                    "vat_percent": 20,
                    "website_json": "{\"region\":\"Salzburg\",\"openingHours\":[{\"key\":\"daily\",\"schema\":[\"Monday\",\"Tuesday\",\"Wednesday\",\"Thursday\",\"Friday\",\"Saturday\",\"Sunday\"],\"ranges\":[{\"opens\":\"08:00\",\"closes\":\"18:00\"}]}],\"school\":{\"name\":\"Skischule Bergdorf\",\"email\":\"buero@skischule-bergdorf.example\",\"phone\":\"+43 000 000020\",\"street\":\"Liftstraße 3\",\"city\":\"5999 Bergdorf\",\"meetingPoint\":{\"lat\":47.2509,\"lng\":13.2008},\"earlyBookingPercent\":0,\"earlyBookingLeadDays\":0}}",
                    "notify_swap_request": 1,
                    "swap_lead_minutes": 90,
                    "swap_from_time": "09:00",
                    "swap_until_time": "15:30",
                    "promo_percent": null,
                    "notify_link_paid": 1,
                    "module_shop": 0,
                    "age_mode": "exact",
                    "payment_secrets_set": 0,
                    "google_reviews_key_set": 0
                  }
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `settings.edit`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Einstellungen ändern",
          "url": "https://docs.ski4.me/referenz/einstellungen/#einstellungen-ändern"
        }
      }
    },
    "/api/ext/v1/catalog": {
      "get": {
        "tags": [
          "Preise"
        ],
        "operationId": "get-catalog",
        "summary": "Katalog der aktiven Preisliste",
        "description": "Beschriftungen in der Standardsprache des Betriebs, Beträge in Cent.\n\nBraucht das Recht `price.view` am Schlüssel.",
        "x-required-permission": "price.view",
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "example": "2026-12-27"
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "type": "integer",
              "minimum": 1,
              "maximum": 60
            },
            "example": 6
          }
        ],
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "from": {
                      "type": "string"
                    },
                    "currency": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "from",
                    "currency"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "shop": "Skiverleih Talstation",
                  "from": "2026-12-27",
                  "days": 6,
                  "currency": "EUR",
                  "categories": [
                    {
                      "code": "ski",
                      "label": "Ski",
                      "kind": "ski",
                      "required": true,
                      "sizeKind": "height",
                      "intro": "Alle Ski kommen frisch geschliffen und gewachst. Die Bindung stellen wir nach ISO 11088 auf dich ein.",
                      "damageWaiverPercent": 10,
                      "models": [
                        {
                          "code": "ski-comfort",
                          "label": "Comfort",
                          "pitch": "Gutmütige Allrounder für die blaue und rote Piste. Verzeihen Fehler und bringen dich sicher runter.",
                          "tier": "comfort",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                2400,
                                4600,
                                6600,
                                8400,
                                10000,
                                11400
                              ],
                              "extraDayCents": 1200
                            },
                            "child": {
                              "daysCents": [
                                900,
                                1700,
                                2400,
                                3000,
                                3500,
                                3900
                              ],
                              "extraDayCents": 400
                            },
                            "youth": {
                              "daysCents": [
                                1200,
                                2200,
                                3100,
                                3900,
                                4600,
                                5200
                              ],
                              "extraDayCents": 600
                            }
                          }
                        },
                        {
                          "code": "ski-prime",
                          "label": "Prime",
                          "pitch": "Aktuelle Modelle der oberen Mittelklasse. Mehr Kantengriff und ruhiger bei Tempo, für alle die zügig fahren.",
                          "tier": "prime",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                3000,
                                5800,
                                8400,
                                10700,
                                12700,
                                14400
                              ],
                              "extraDayCents": 1500
                            }
                          }
                        },
                        {
                          "code": "ski-superior",
                          "label": "Superior",
                          "pitch": "Top-Modelle der laufenden Saison, jede Woche frisch serviciert. Für Könner.",
                          "tier": "superior",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                3600,
                                7000,
                                10100,
                                12900,
                                15300,
                                17400
                              ],
                              "extraDayCents": 1800
                            }
                          }
                        }
                      ]
                    },
                    {
                      "code": "snowboard",
                      "label": "Snowboard",
                      "kind": "snowboard",
                      "required": true,
                      "sizeKind": "height",
                      "intro": "Boards für Piste und Powder, Bindung auf deinen Stand eingestellt.",
                      "damageWaiverPercent": 10,
                      "models": [
                        {
                          "code": "snowboard-comfort",
                          "label": "Comfort",
                          "pitch": "Weiche, drehfreudige Allmountain-Boards. Ideal zum Lernen und für entspannte Pistentage.",
                          "tier": "comfort",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                2400,
                                4600,
                                6600,
                                8400,
                                10000,
                                11400
                              ],
                              "extraDayCents": 1200
                            },
                            "youth": {
                              "daysCents": [
                                1200,
                                2200,
                                3100,
                                3900,
                                4600,
                                5200
                              ],
                              "extraDayCents": 600
                            }
                          }
                        },
                        {
                          "code": "snowboard-prime",
                          "label": "Prime",
                          "pitch": "Stabilere Boards mit mehr Pop. Für sicheres Fahren bei Tempo und den Ausflug in den Park.",
                          "tier": "prime",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                3000,
                                5800,
                                8400,
                                10700,
                                12700,
                                14400
                              ],
                              "extraDayCents": 1500
                            }
                          }
                        }
                      ]
                    },
                    {
                      "code": "skiboots",
                      "label": "Skischuhe",
                      "kind": "boots",
                      "required": false,
                      "sizeKind": "shoe",
                      "requires": "ski",
                      "intro": "Der Schuh entscheidet über den Tag. Wir messen im Shop nach und passen an, Bootfitting inklusive.",
                      "damageWaiverPercent": 10,
                      "models": [
                        {
                          "code": "skiboots-comfort",
                          "label": "Comfort",
                          "pitch": "Bequeme Schuhe mit weicherem Flex. Warm, unkompliziert, gut für lange Tage.",
                          "tier": "comfort",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                1200,
                                2200,
                                3000,
                                3600,
                                4100,
                                4500
                              ],
                              "extraDayCents": 400
                            },
                            "child": {
                              "daysCents": [
                                500,
                                900,
                                1200,
                                1400,
                                1600,
                                1700
                              ],
                              "extraDayCents": 200
                            },
                            "youth": {
                              "daysCents": [
                                600,
                                1000,
                                1300,
                                1600,
                                1800,
                                2000
                              ],
                              "extraDayCents": 200
                            }
                          }
                        },
                        {
                          "code": "skiboots-prime",
                          "label": "Prime",
                          "pitch": "Direktere Kraftübertragung, präziserer Sitz. Für alle, die sportlich fahren.",
                          "tier": "prime",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                1600,
                                3000,
                                4200,
                                5200,
                                6000,
                                6600
                              ],
                              "extraDayCents": 600
                            }
                          }
                        }
                      ]
                    },
                    {
                      "code": "softboots",
                      "label": "Snowboard-Boots",
                      "kind": "boots",
                      "required": false,
                      "sizeKind": "shoe",
                      "requires": "snowboard",
                      "intro": "Softboots in allen gängigen Größen, frisch desinfiziert.",
                      "damageWaiverPercent": 10,
                      "models": [
                        {
                          "code": "softboots",
                          "label": "Softboots",
                          "pitch": "Bequem, warm und mit gutem Halt. Passen zu jedem unserer Boards.",
                          "tier": "comfort",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                1200,
                                2200,
                                3000,
                                3600,
                                4100,
                                4500
                              ],
                              "extraDayCents": 400
                            },
                            "child": {
                              "daysCents": [
                                500,
                                900,
                                1200,
                                1400,
                                1600,
                                1700
                              ],
                              "extraDayCents": 200
                            },
                            "youth": {
                              "daysCents": [
                                600,
                                1000,
                                1300,
                                1600,
                                1800,
                                2000
                              ],
                              "extraDayCents": 200
                            }
                          }
                        }
                      ]
                    },
                    {
                      "code": "helmet",
                      "label": "Helm",
                      "kind": "helmet",
                      "required": false,
                      "sizeKind": "head",
                      "intro": "Für Kinder bis 12 Jahre ist der Helm bei jedem Verleih gratis dabei.",
                      "damageWaiverPercent": 10,
                      "models": [
                        {
                          "code": "helmet",
                          "label": "Helm",
                          "pitch": "Leichter Skihelm mit verstellbarem Ring. Passt über die eigene Brille.",
                          "tier": "comfort",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                600,
                                1100,
                                1500,
                                1900,
                                2200,
                                2400
                              ],
                              "extraDayCents": 200
                            },
                            "child": {
                              "daysCents": [
                                600,
                                1100,
                                1500,
                                1900,
                                2200,
                                2400
                              ],
                              "extraDayCents": 200
                            },
                            "youth": {
                              "daysCents": [
                                600,
                                1100,
                                1500,
                                1900,
                                2200,
                                2400
                              ],
                              "extraDayCents": 200
                            }
                          }
                        },
                        {
                          "code": "helmet-visor",
                          "label": "Helm mit Visier",
                          "pitch": "Visier statt Brille. Beschlägt weniger und geht auch über der Sehbrille.",
                          "tier": "prime",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                900,
                                1700,
                                2400,
                                3000,
                                3500,
                                3900
                              ],
                              "extraDayCents": 400
                            },
                            "child": {
                              "daysCents": [
                                900,
                                1700,
                                2400,
                                3000,
                                3500,
                                3900
                              ],
                              "extraDayCents": 400
                            },
                            "youth": {
                              "daysCents": [
                                900,
                                1700,
                                2400,
                                3000,
                                3500,
                                3900
                              ],
                              "extraDayCents": 400
                            }
                          }
                        }
                      ]
                    },
                    {
                      "code": "protector",
                      "label": "Rückenprotektor",
                      "kind": "protector",
                      "required": false,
                      "sizeKind": "height",
                      "intro": "Empfohlen für Kinder, Snowboarder und alle, die abseits der Piste unterwegs sind.",
                      "damageWaiverPercent": 10,
                      "models": [
                        {
                          "code": "protector",
                          "label": "Protektor",
                          "pitch": "Rückenprotektor als Weste. Sitzt unter der Jacke und stört nicht beim Fahren.",
                          "tier": "comfort",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                700,
                                1300,
                                1800,
                                2200,
                                2500,
                                2800
                              ],
                              "extraDayCents": 300
                            },
                            "child": {
                              "daysCents": [
                                700,
                                1300,
                                1800,
                                2200,
                                2500,
                                2800
                              ],
                              "extraDayCents": 300
                            },
                            "youth": {
                              "daysCents": [
                                700,
                                1300,
                                1800,
                                2200,
                                2500,
                                2800
                              ],
                              "extraDayCents": 300
                            }
                          }
                        }
                      ]
                    },
                    {
                      "code": "sled",
                      "label": "Rodel",
                      "kind": "standalone",
                      "required": false,
                      "sizeKind": "none",
                      "intro": "Für den Abend auf der Rodelbahn. Auch ohne Skiverleih ausleihbar.",
                      "damageWaiverPercent": 10,
                      "models": [
                        {
                          "code": "sled",
                          "label": "Rodel",
                          "pitch": "Klassische Holzrodel mit Lenkgurt. Nimm sie gleich für den Abend mit.",
                          "tier": "comfort",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                800,
                                1500,
                                2100,
                                2600,
                                3000,
                                3300
                              ],
                              "extraDayCents": 300
                            },
                            "child": {
                              "daysCents": [
                                800,
                                1500,
                                2100,
                                2600,
                                3000,
                                3300
                              ],
                              "extraDayCents": 300
                            },
                            "youth": {
                              "daysCents": [
                                800,
                                1500,
                                2100,
                                2600,
                                3000,
                                3300
                              ],
                              "extraDayCents": 300
                            }
                          }
                        }
                      ]
                    },
                    {
                      "code": "crosscountry",
                      "label": "Langlauf",
                      "kind": "standalone",
                      "required": false,
                      "sizeKind": "height",
                      "intro": "Komplettsets inklusive Schuhe und Stöcke. Die Loipe startet im Tal.",
                      "damageWaiverPercent": 10,
                      "models": [
                        {
                          "code": "xc-classic",
                          "label": "Klassisch SET",
                          "pitch": "Ski, Schuhe und Stöcke für die klassische Spur. Der ruhige Einstieg in den Langlauf.",
                          "tier": "comfort",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                1500,
                                2800,
                                4000,
                                5100,
                                6100,
                                7000
                              ],
                              "extraDayCents": 700
                            },
                            "child": {
                              "daysCents": [
                                1500,
                                2800,
                                4000,
                                5100,
                                6100,
                                7000
                              ],
                              "extraDayCents": 700
                            },
                            "youth": {
                              "daysCents": [
                                1500,
                                2800,
                                4000,
                                5100,
                                6100,
                                7000
                              ],
                              "extraDayCents": 700
                            }
                          }
                        },
                        {
                          "code": "xc-skating",
                          "label": "Skating SET",
                          "pitch": "Leichtes Skating-Set für alle, die Tempo und Ausdauer suchen.",
                          "tier": "prime",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                2000,
                                3800,
                                5500,
                                7000,
                                8400,
                                9600
                              ],
                              "extraDayCents": 900
                            },
                            "child": {
                              "daysCents": [
                                2000,
                                3800,
                                5500,
                                7000,
                                8400,
                                9600
                              ],
                              "extraDayCents": 900
                            },
                            "youth": {
                              "daysCents": [
                                2000,
                                3800,
                                5500,
                                7000,
                                8400,
                                9600
                              ],
                              "extraDayCents": 900
                            }
                          }
                        }
                      ]
                    },
                    {
                      "code": "poles",
                      "label": "Skistöcke",
                      "kind": "poles",
                      "required": false,
                      "sizeKind": "none",
                      "intro": "Zu Ski gehören die Stöcke gratis dazu. Einzeln verliehen kosten sie den Tagessatz.",
                      "damageWaiverPercent": 10,
                      "models": [
                        {
                          "code": "poles",
                          "label": "poles",
                          "pitch": "",
                          "tier": "comfort",
                          "image": null,
                          "ladders": {
                            "adult": {
                              "daysCents": [
                                400,
                                800,
                                1200,
                                1600,
                                2000,
                                2400
                              ],
                              "extraDayCents": 400
                            },
                            "child": {
                              "daysCents": [
                                300,
                                600,
                                900,
                                1200,
                                1500,
                                1800
                              ],
                              "extraDayCents": 300
                            },
                            "youth": {
                              "daysCents": [
                                300,
                                600,
                                900,
                                1200,
                                1500,
                                1800
                              ],
                              "extraDayCents": 300
                            }
                          }
                        }
                      ]
                    }
                  ],
                  "rules": {
                    "childMaxAge": 6,
                    "youthMaxAge": 14,
                    "helmetFreeMaxAge": 12,
                    "polesFreeWith": "ski",
                    "depositCents": 0,
                    "waiverPercent": 10,
                    "lateReturnFeeCents": 500,
                    "vatPercent": 20,
                    "familyChildMaxAge": 10,
                    "familyRequiredAdults": 2,
                    "earlyPercent": null,
                    "earlyLeadDays": null,
                    "promoPercent": null,
                    "ageMode": "exact"
                  },
                  "times": {
                    "returnTime": "18:00",
                    "lateReturnTime": "10:00"
                  },
                  "services": [
                    {
                      "code": "service-small",
                      "adultCents": 3000,
                      "childCents": 2000,
                      "boardCents": 3800
                    },
                    {
                      "code": "service-large",
                      "adultCents": 4200,
                      "childCents": 3000,
                      "boardCents": 5000
                    },
                    {
                      "code": "wax-machine",
                      "adultCents": 900,
                      "childCents": 700,
                      "boardCents": 1100
                    },
                    {
                      "code": "wax-hand",
                      "adultCents": 1800,
                      "childCents": 1800,
                      "boardCents": 1800
                    },
                    {
                      "code": "binding-adjust",
                      "adultCents": 800,
                      "childCents": 800,
                      "boardCents": 800
                    },
                    {
                      "code": "mount-adjust",
                      "adultCents": 2800,
                      "childCents": 2800,
                      "boardCents": 2800
                    }
                  ],
                  "cancelTiers": [
                    {
                      "minDaysBefore": 60,
                      "feePercent": 0
                    },
                    {
                      "minDaysBefore": 30,
                      "feePercent": 25
                    },
                    {
                      "minDaysBefore": 14,
                      "feePercent": 50
                    },
                    {
                      "minDaysBefore": 1,
                      "feePercent": 80
                    }
                  ],
                  "fetchedAt": "2026-11-10T08:00:23.290Z"
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `price.view`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Katalog lesen",
          "url": "https://docs.ski4.me/referenz/katalog/#katalog-lesen"
        }
      }
    },
    "/api/ext/v1/courses": {
      "get": {
        "tags": [
          "Kurse"
        ],
        "operationId": "get-courses",
        "summary": "Vermittelte Kurse, für die Skischule",
        "description": "Je Kursposten ein Eintrag mit Termin, Treffpunkt, Sprache, Niveau, Teilnehmern mit Alter und einer Kontaktperson. Nichts aus dem Verleih, keine Zahlungsdaten und nicht die Provision. `since` nimmt den Wert `asOf` der vorigen Antwort und liefert nur, was sich seither geändert hat. Was hier abgeholt wird, gilt im Portal als gemeldet.\n\nBraucht das Recht `course.view` am Schlüssel.",
        "x-required-permission": "course.view",
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "example": "2026-12-27"
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
            },
            "example": "2027-01-02"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "booked",
                "changed",
                "cancelled"
              ]
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "default": 200,
              "type": "integer",
              "minimum": 1,
              "maximum": 1000
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "courses": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "uid": {
                            "type": "string"
                          },
                          "bookingRef": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "booked",
                              "changed",
                              "cancelled"
                            ]
                          },
                          "provider": {
                            "type": "string"
                          },
                          "courseId": {
                            "type": "string"
                          },
                          "courseName": {
                            "type": "string"
                          },
                          "variantId": {
                            "type": "string"
                          },
                          "date": {
                            "type": "string"
                          },
                          "days": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "timeFrom": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "meetingPointId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "meetingPointName": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "skillId": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "skillName": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "language": {
                            "type": "string"
                          },
                          "persons": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "participants": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "firstName": {
                                  "type": "string"
                                },
                                "lastName": {
                                  "type": "string"
                                },
                                "age": {
                                  "anyOf": [
                                    {
                                      "type": "integer",
                                      "minimum": -9007199254740991,
                                      "maximum": 9007199254740991
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                }
                              },
                              "required": [
                                "firstName",
                                "lastName",
                                "age"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "contact": {
                            "anyOf": [
                              {
                                "type": "object",
                                "properties": {
                                  "name": {
                                    "type": "string"
                                  },
                                  "email": {
                                    "type": "string"
                                  },
                                  "phone": {
                                    "type": "string"
                                  }
                                },
                                "required": [
                                  "name",
                                  "email",
                                  "phone"
                                ],
                                "additionalProperties": false
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "amountCents": {
                            "type": "integer",
                            "minimum": -9007199254740991,
                            "maximum": 9007199254740991
                          },
                          "currency": {
                            "type": "string"
                          },
                          "bookedAt": {
                            "type": "string"
                          },
                          "updatedAt": {
                            "type": "string"
                          },
                          "reportedAt": {
                            "type": [
                              "string",
                              "null"
                            ]
                          }
                        },
                        "required": [
                          "uid",
                          "bookingRef",
                          "status",
                          "provider",
                          "courseId",
                          "courseName",
                          "variantId",
                          "date",
                          "days",
                          "timeFrom",
                          "meetingPointId",
                          "meetingPointName",
                          "skillId",
                          "skillName",
                          "language",
                          "persons",
                          "participants",
                          "contact",
                          "amountCents",
                          "currency",
                          "bookedAt",
                          "updatedAt",
                          "reportedAt"
                        ],
                        "additionalProperties": {}
                      }
                    },
                    "asOf": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "courses",
                    "asOf"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "courses": [
                    {
                      "uid": "01a1db4a-b5a4-7331-84c1-5c71a25feb38",
                      "bookingRef": "SB-261114-WWNP",
                      "status": "booked",
                      "provider": "eigen",
                      "courseId": "kinder-3t",
                      "courseName": "Kinderkurs, 3 Tage",
                      "variantId": "1",
                      "date": "2026-12-28",
                      "days": 3,
                      "timeFrom": "10:00",
                      "meetingPointId": "schule",
                      "meetingPointName": "Treffpunkt der Skischule",
                      "skillId": "beginner",
                      "skillName": "Anfänger",
                      "language": "de",
                      "persons": 1,
                      "participants": [
                        {
                          "firstName": "Leon",
                          "lastName": "Berger",
                          "age": 11
                        }
                      ],
                      "contact": {
                        "name": "Martin Berger",
                        "email": "martin.berger@example.org",
                        "phone": "+49 000 0000002"
                      },
                      "amountCents": 19500,
                      "currency": "EUR",
                      "bookedAt": "2026-11-14T18:22:44.270Z",
                      "updatedAt": "2026-11-14T18:21:08.900Z",
                      "reportedAt": "2026-11-14T18:23:26.640Z"
                    },
                    {
                      "uid": "01a1d0a1-941e-7285-840a-b1ba0e382d8d",
                      "bookingRef": "SB-261112-WDZH",
                      "status": "cancelled",
                      "provider": "eigen",
                      "courseId": "privat-1h",
                      "courseName": "Private ski lesson",
                      "variantId": "3",
                      "date": "2026-12-29",
                      "days": 1,
                      "timeFrom": "13:30",
                      "meetingPointId": "schule",
                      "meetingPointName": "the ski school meeting point",
                      "skillId": "advanced",
                      "skillName": "Advanced",
                      "language": "en",
                      "persons": 1,
                      "participants": [
                        {
                          "firstName": "Petra",
                          "lastName": "Novak",
                          "age": 36
                        }
                      ],
                      "contact": {
                        "name": "Petra Novak",
                        "email": "petra.novak@example.org",
                        "phone": "+43 000 000004"
                      },
                      "amountCents": 7900,
                      "currency": "EUR",
                      "bookedAt": "2026-11-12T16:41:47.944Z",
                      "updatedAt": "2026-11-20T08:14:55.400Z",
                      "reportedAt": "2026-11-14T18:23:26.640Z"
                    }
                  ],
                  "asOf": "2026-12-20T06:00:04.782Z"
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `course.view`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Kurse auflisten",
          "url": "https://docs.ski4.me/referenz/kurse/#kurse-auflisten"
        }
      }
    },
    "/api/ext/v1/courses/{uid}": {
      "get": {
        "tags": [
          "Kurse"
        ],
        "operationId": "get-courses-by-uid",
        "summary": "Ein vermittelter Kurs",
        "description": "`uid` bleibt über Buchung, Änderung und Storno dieselbe.\n\nBraucht das Recht `course.view` am Schlüssel.",
        "x-required-permission": "course.view",
        "parameters": [
          {
            "name": "uid",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Die Nummer des Eintrags.",
            "example": "01a1db4a-b5a4-7331-84c1-5c71a25feb38"
          }
        ],
        "responses": {
          "200": {
            "description": "Erfolg",
            "content": {
              "application/json": {
                "schema": {
                  "$schema": "https://json-schema.org/draft/2020-12/schema",
                  "type": "object",
                  "properties": {
                    "uid": {
                      "type": "string"
                    },
                    "bookingRef": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "booked",
                        "changed",
                        "cancelled"
                      ]
                    },
                    "provider": {
                      "type": "string"
                    },
                    "courseId": {
                      "type": "string"
                    },
                    "courseName": {
                      "type": "string"
                    },
                    "variantId": {
                      "type": "string"
                    },
                    "date": {
                      "type": "string"
                    },
                    "days": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "timeFrom": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "meetingPointId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "meetingPointName": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "skillId": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "skillName": {
                      "type": [
                        "string",
                        "null"
                      ]
                    },
                    "language": {
                      "type": "string"
                    },
                    "persons": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "participants": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "firstName": {
                            "type": "string"
                          },
                          "lastName": {
                            "type": "string"
                          },
                          "age": {
                            "anyOf": [
                              {
                                "type": "integer",
                                "minimum": -9007199254740991,
                                "maximum": 9007199254740991
                              },
                              {
                                "type": "null"
                              }
                            ]
                          }
                        },
                        "required": [
                          "firstName",
                          "lastName",
                          "age"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "contact": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string"
                            },
                            "email": {
                              "type": "string"
                            },
                            "phone": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "name",
                            "email",
                            "phone"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "amountCents": {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    "currency": {
                      "type": "string"
                    },
                    "bookedAt": {
                      "type": "string"
                    },
                    "updatedAt": {
                      "type": "string"
                    },
                    "reportedAt": {
                      "type": [
                        "string",
                        "null"
                      ]
                    }
                  },
                  "required": [
                    "uid",
                    "bookingRef",
                    "status",
                    "provider",
                    "courseId",
                    "courseName",
                    "variantId",
                    "date",
                    "days",
                    "timeFrom",
                    "meetingPointId",
                    "meetingPointName",
                    "skillId",
                    "skillName",
                    "language",
                    "persons",
                    "participants",
                    "contact",
                    "amountCents",
                    "currency",
                    "bookedAt",
                    "updatedAt",
                    "reportedAt"
                  ],
                  "additionalProperties": {}
                },
                "example": {
                  "uid": "01a1db4a-b5a4-7331-84c1-5c71a25feb38",
                  "bookingRef": "SB-261114-WWNP",
                  "status": "booked",
                  "provider": "eigen",
                  "courseId": "kinder-3t",
                  "courseName": "Kinderkurs, 3 Tage",
                  "variantId": "1",
                  "date": "2026-12-28",
                  "days": 3,
                  "timeFrom": "10:00",
                  "meetingPointId": "schule",
                  "meetingPointName": "Treffpunkt der Skischule",
                  "skillId": "beginner",
                  "skillName": "Anfänger",
                  "language": "de",
                  "persons": 1,
                  "participants": [
                    {
                      "firstName": "Leon",
                      "lastName": "Berger",
                      "age": 11
                    }
                  ],
                  "contact": {
                    "name": "Martin Berger",
                    "email": "martin.berger@example.org",
                    "phone": "+49 000 0000002"
                  },
                  "amountCents": 19500,
                  "currency": "EUR",
                  "bookedAt": "2026-11-14T18:22:44.270Z",
                  "updatedAt": "2026-11-14T18:21:08.900Z",
                  "reportedAt": "2026-11-14T18:23:26.640Z"
                }
              }
            }
          },
          "400": {
            "description": "Die Anfrage ist nicht gültig. `hint` nennt das erste Feld.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Der Schlüssel fehlt, ist falsch, abgelaufen oder widerrufen.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/Unauthorized"
                  }
                }
              }
            }
          },
          "403": {
            "description": "Dem Schlüssel fehlt das Recht `course.view`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "Diesen Eintrag gibt es nicht.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Zu viele Anfragen. `Retry-After` nennt die Wartezeit in Sekunden.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "required": [
                        "code",
                        "message",
                        "status"
                      ],
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Für Maschinen. Ändert sich nie.",
                          "enum": [
                            "invalid_request",
                            "unauthorized",
                            "forbidden",
                            "not_found",
                            "method_not_allowed",
                            "conflict",
                            "rate_limited",
                            "service_unavailable",
                            "payment_unavailable",
                            "internal_error"
                          ]
                        },
                        "message": {
                          "type": "string",
                          "description": "Für Menschen, in der Sprache der Anfrage."
                        },
                        "status": {
                          "type": "integer"
                        },
                        "hint": {
                          "type": "string",
                          "description": "Nennt immer einen nächsten Schritt."
                        },
                        "documentation_url": {
                          "type": "string"
                        }
                      }
                    }
                  }
                },
                "examples": {
                  "beispiel": {
                    "$ref": "#/components/examples/RateLimited"
                  }
                }
              }
            }
          }
        },
        "externalDocs": {
          "description": "Einen Kurs lesen",
          "url": "https://docs.ski4.me/referenz/kurse/#einen-kurs-lesen"
        }
      }
    }
  },
  "externalDocs": {
    "description": "Entwicklerdokumentation",
    "url": "https://docs.ski4.me"
  }
}