Verfügbarkeit

Nächte sperren oder freigeben

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

Nächte sperren, freigeben oder den Verkauf ganz stoppen.

to ist die letzte betroffene NACHT, nicht der Abreisetag — anders als bei einer Buchung, wo check_out der Abreisetag ist. Das ist bewusst so: hier beschreibst du Nächte, dort einen Aufenthalt.

Gebuchte Nächte werden nie überschrieben. Sie erscheinen in nights_skipped; der Rest wird gesetzt. Ein Aufruf, der ausschließlich auf gebuchte Nächte trifft, ist deshalb kein Fehler, sondern ein Ergebnis mit nights_changed: 0 — der Client sieht am Zähler, was passiert ist, statt einen 409 deuten zu müssen.

Anfrage-Körperpflicht

actionstringpflicht

Erlaubt:blockopenstop_sellresume_sell

fromdatepflicht

notestring

Grund, erscheint im Kalender des Betriebs.

property_idstringpflicht

todatepflicht

Letzte betroffene NACHT (einschließlich), nicht der Abreisetag.

unit_idstring

Nur für block/open: eine bestimmte Einheit. Ohne Angabe gilt die Aktion für ALLE Einheiten des Objekts.

Antworten

200Successful Response

actionstringpflicht

fromdatepflicht

nights_changedintegerpflicht

Wie viele Nacht-/Einheit-Kombinationen sich geändert haben. 0 heißt: der gewünschte Zustand galt bereits.

nights_skippedintegerpflicht

Nächte, die nicht geändert wurden, weil sie gebucht sind. Eine Buchung wird hier nie überschrieben.

property_idstringpflicht

todatepflicht

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 PUT 'https://open-api.mynextdays.com/v1/availability' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "property_id": "…",
  "from": "2026-09-10",
  "to": "2026-09-10",
  "action": "block"
}'

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

Beispiel

{
  "property_id": "…",
  "from": "2026-09-10",
  "to": "2026-09-10",
  "action": "…",
  "nights_changed": 1,
  "nights_skipped": 1
}