Buchungen

Buchungen auflisten

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

Buchungen des Betriebs, gefiltert.

Sortiert nach Anreise, dann ID — eine stabile Ordnung, damit Blättern keine Zeilen doppelt oder gar nicht liefert.

Zum Sortieren „neueste zuerst" nimm booked_at auf deiner Seite und behandle null als unbekannt. NICHT received_at dafür verwenden: das ist unser Eingang, und bei einem Sammel-Import tragen Dutzende Buchungen dieselbe Sekunde.

Query-Parameter

property_idstring

Nur Buchungen dieses Objekts.

statusstring

channelstring

Kanal-Filter.

check_in_fromdate

Anreise ab (einschließlich).

check_in_todate

Anreise bis (einschließlich).

updated_sincestring

Nur Buchungen, die seit diesem Zeitpunkt geändert wurden (ISO 8601). Der sparsame Weg für einen laufenden Abgleich.

limitinteger

offsetinteger

starting_afterstring

ID des letzten Elements der Vorseite — der empfohlene Weg zum Blättern. Stabil, auch wenn sich die Liste zwischen zwei Seiten ändert. Schließt offset aus. Den Wert liefert pagination.next_starting_after der Vorseite. Die übrigen Filter musst du beim Weiterblättern unverändert mitschicken. Änderst du sie, beschreibt der Cursor eine Stelle in einer anderen Liste, und das Ergebnis ist nicht vorhersagbar. limit darf sich ändern. Der Cursor läuft nicht ab. Er wird ungültig, wenn der Datensatz gelöscht wird — dann kommt ein 422, und du beginnst den Durchgang ohne starting_after neu.

include_totalbooleanStandard false

Antworten

200Successful Response

dataarray of Buchungpflicht

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

paginationBlaetterinfopflicht

Der pagination-Block, der bei JEDER Liste gleich aussieht.

has_morebooleanpflicht

Es gibt eine weitere Seite. Dann steht next_starting_after dabei.

limitintegerpflicht

next_starting_afterstring

Cursor für die nächste Seite — unverändert als starting_after mitschicken. Fehlt das Feld, ist der Durchgang fertig.

offsetintegerpflicht

totalinteger

Gesamtzahl der Treffer. Nur vorhanden, wenn include_total=true.

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' \
  -H 'Authorization: Bearer <access_token>'

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

Beispiel

{
  "data": [
    {
      "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": "…"
      }
    }
  ],
  "pagination": {
    "limit": 1,
    "offset": 1,
    "has_more": false
  }
}