Gäste

Gäste auflisten

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

Gäste des Betriebs.

Anonymisierte Gäste (Löschverlangen nach DSGVO ausgeführt) erscheinen nicht. Sie aus der Liste zu nehmen ist Teil der Löschung — ein Client, der sie noch einmal abholt, würde sie bei sich wieder aufbauen.

Query-Parameter

emailstring

Exakte E-Mail-Adresse.

searchstring

Namensteil (mindestens zwei Zeichen).

updated_sincestring

Geändert seit (ISO 8601).

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 GastProfilpflicht

companystring

countrystring

created_atdate-time

emailstring

first_namestring

idstring

languagestring

last_namestring

last_stay_atdate

namestring

phonestring

segmentstring

stays_countinteger

Zahl der abgeschlossenen Aufenthalte.

updated_atdate-time

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

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

Beispiel

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