Buchungen

Eine Buchung lesen

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

Eine Buchung samt Gastdaten und Beträgen.

Pfad-Parameter

reservation_idstringpflicht

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

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/reservations/%3Creservation_id%3E' \
  -H 'Authorization: Bearer <access_token>'

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": "…"
  }
}