Verfügbarkeit

Verfügbarkeit lesen

gethttps://open-api.mynextdays.com/v1/availability

Freie Einheiten je Tag oder Zeitraum.

units_available: 0 heißt „an diesem Tag ist nichts verkäuflich" — der Grund kann eine Buchung, eine Handsperre oder ein Verkaufsstopp sein. Mit granularity=days steht der Grund dabei.

Query-Parameter

property_idstringpflicht

Objekt, dessen Kalender gelesen wird.

fromdatepflicht

Erste Nacht.

todatepflicht

Letzte Nacht (einschließlich).

granularitystringStandard spans

spans (Standard): zusammenhängende Zeiträume gleicher Stückzahl — ein Jahr sind so meist ein Dutzend Zeilen statt 365. days: eine Zeile je Tag, zusätzlich mit Aufenthaltsregeln und Verkaufsstopp.

Antworten

200Successful Response

dataarray of VerfuegbarkeitsSpanne | array of VerfuegbarkeitsTagpflicht

granularitystringpflicht

Erlaubt:spansdays

property_idstringpflicht

422Validation Error

detailarray of ValidationError

ctxContext

inputInput

locarray of string | integerpflicht

msgstringpflicht

typestringpflicht

Sprache

Zugang

Nur in diesem Browser, nur für „Ausprobieren“ — der Wert wird nicht gespeichert und nicht an uns geschickt.

Anfrage

curl -X GET 'https://open-api.mynextdays.com/v1/availability?property_id=%3Cproperty_id%3E&from=%3Cfrom%3E&to=%3Cto%3E' \
  -H 'Authorization: Bearer <access_token>'

Ohne Token antwortet der Aufruf mit 401 — das ist der erwartete Weg.

Beispiel

{
  "property_id": "…",
  "granularity": "spans",
  "data": [
    {
      "from": "2026-09-10",
      "to": "2026-09-10",
      "units_available": 1
    }
  ]
}