Webhooks

Ereignisse abrufen

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

Die Ereignisse deines Betriebs, älteste zuerst.

Älteste zuerst ist Absicht. Wer nachholt, will die Ereignisse in der Reihenfolge verarbeiten, in der sie entstanden sind — sonst überschreibt eine ältere Änderung eine neuere. Für die Push-Zustellung gilt die Reihenfolge NICHT als garantiert; hier schon, weil du selbst blätterst.

Jedes Ereignis trägt dieselbe id wie die zugestellte Fassung. Damit erkennst du, was du schon verarbeitet hast, und kannst Push und Abruf mischen, ohne etwas doppelt zu tun.

Query-Parameter

sincedate-time

Nur Ereignisse ab diesem Zeitpunkt (ISO 8601, UTC). Ohne Angabe: die letzten 24 Stunden. Höchstens 30 Tage zurück.

eventstring

Auf einen Ereignistyp einschränken, z. B. reservation.created. Mehrere durch Komma.

property_idstring

Nur Ereignisse dieses Objekts.

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.

Antworten

200Successful Response

dataarray of Ereignispflicht

created_atdate-timepflicht

dataDatapflicht

eventstringpflicht

idstringpflicht

property_idstring

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

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

Beispiel

{
  "data": [
    {
      "id": "…",
      "event": "…",
      "created_at": "2026-09-10T14:00:00Z",
      "data": {}
    }
  ],
  "pagination": {
    "limit": 1,
    "offset": 1,
    "has_more": false
  }
}