myNextDays

Buchungen

Buchung ändern

patchhttps://open-api.mynextdays.com/v1/reservations/{reservation_id}

Gästezahl, Notiz, Zeiten und Gastkontakt ändern.

NICHT möglich: verschieben, das Objekt wechseln, den Status setzen oder Beträge überschreiben. Diese Änderungen haben Gegenzustände — belegte Nächte, Portal-Meldung, Rechnung — und laufen deshalb dort, wo diese Kette vollständig gepflegt wird.

Pfad-Parameter

reservation_idstringpflicht

Anfrage-Körperpflicht

adultsinteger
checkin_timestring

Erwartete Ankunftszeit als HH:MM, oder null zum Löschen.

checkout_timestring
childreninteger
external_refstring
guest_emailstring
guest_languagestring
guest_phonestring
infantsinteger
notestring
petsinteger

Antworten

200Successful Response
booked_atdate-time

Wann der GAST gebucht hat — aus der Quelle des Portals. null, wenn das Portal den Zeitpunkt nicht liefert. Dann ist received_at das Einzige, was wir wissen; verwende NICHT received_at als Buchungszeitpunkt.

cancelled_atdate-time
cancelled_by_partystring

Wer storniert hat: guest | host | ota | system.

channelstringpflicht

Buchungskanal: direct (Betrieb selbst, auch über diese API), portal (myBestDays-Marktplatz), website (eigene Seite), booking, airbnb, vrbo, ota_other.

check_indatepflicht
check_outdatepflicht
external_refstring

Buchungsnummer beim Portal.

guestGastpflicht
countrystring
emailstring
first_namestring
idstring
languagestring
last_namestring
namestring
phonestring
guestsGuestspflicht

Aufschlüsselung: adults, children, infants, pets.

idstringpflicht
nightsintegerpflicht
notestring
ota_namestring

Name des Portals, wenn die Buchung von dort kommt.

paidBetragpflicht

Ein Betrag mit seiner Währung. Nie eine Zahl ohne Währung.

amountstringpflicht
currencystringpflicht
payment_statusstring
property_idstringpflicht
rate_plan_idstring
received_atdate-timepflicht

Wann die Buchung bei uns eingegangen ist (unsere Uhr).

statusstringpflicht
Erlaubt:pendingconfirmedcancelledcompletedrequesteddeclinedexpired
totalBetragpflicht

Ein Betrag mit seiner Währung. Nie eine Zahl ohne Währung.

amountstringpflicht
currencystringpflicht
unit_idstring

Belegte Einheit. null bei Altbestand ohne Zuweisung oder wenn die Einheit gelöscht wurde.

updated_atdate-timepflicht
422Ein Wert ist unmöglich, oder es wurde versucht, Zeitraum, Objekt oder Status zu ändern — das geht über diesen Endpunkt nicht.

Sprache

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

Anfrage
curl -X PATCH 'https://open-api.mynextdays.com/v1/reservations/%3Creservation_id%3E' \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "adults": 1,
  "checkin_time": "…",
  "checkout_time": "…",
  "children": 0
}'

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

Beispiel
{
  "id": "…",
  "property_id": "…",
  "status": "pending",
  "channel": "…",
  "check_in": "2026-09-10",
  "check_out": "2026-09-10",
  "nights": 1,
  "guests": {},
  "total": {
    "amount": "…",
    "currency": "…"
  },
  "paid": {
    "amount": "…",
    "currency": "…"
  },
  "received_at": "2026-09-10T14:00:00Z",
  "updated_at": "2026-09-10T14:00:00Z",
  "guest": {
    "country": "…",
    "email": "…",
    "first_name": "…",
    "id": "…"
  }
}