Objekte
Objekte auflisten
https://open-api.mynextdays.com/v1/propertiesAlle Objekte des Betriebs, auf die dieser Zugang Zugriff hat.
Sortiert nach Titel, damit die Reihenfolge über Seiten hinweg stabil ist — ohne stabile Sortierung kann Blättern Zeilen doppelt oder gar nicht liefern.
Query-Parameter
statusstringNach Status filtern: draft | active | inactive.
building_idstringNur Objekte dieses Gebäudes.
archivedbooleanOhne Angabe: nur AKTIVE Objekte (archivierte bleiben weg). true liefert ausschließlich archivierte — der Weg, sie im eigenen System ebenfalls stillzulegen. false ist dasselbe wie keine Angabe, nur ausdrücklich.
updated_sincestringNur Objekte, die seit diesem Zeitpunkt geändert wurden (ISO 8601). Der sparsame Weg für einen regelmäßigen Abgleich.
limitintegeroffsetintegerstarting_afterstringID 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 falseGesamtzahl mitzählen. Kostet eine zusätzliche Zählung — nur anfordern, wenn du sie anzeigst.
Antworten
dataarray of ObjektpflichtaddressAddresspflichtAdresse in Einzelfeldern (street, house_number, postal_code, city, country).
amenitiesarray of stringbuilding_idstringGebäude, unter dem dieses Objekt bei den Portalen geführt wird. Mehrere Objekte desselben Gebäudes teilen dort eine Kennung.
category_slugstringchannelsChannelspflichtKanal-Sichtbarkeit, je Kanal einzeln: marketplace (myBestDays), website (eigene Seite). Es gibt kein globales „veröffentlicht-Flag.
created_atdate-timepflichtcurrencystringpflichtWährungscode (ISO 4217) dieses Objekts.
idstringpflichtlatnumberlisting_typestringentire_place | private_room | shared_room.
lngnumbermax_guestsintegerpflichtphotosarray of stringproperty_typestringstatusstringpflichtNur active ist verkäuflich. draft ist unfertig, inactive aus dem Verkauf genommen.
subtype_slugstringtimezonestringZeitzone des Objekts (IANA). Kalendertage beziehen sich darauf.
titlestringpflichtunits_totalintegerpflichtZahl der Einheiten dieses Typs (mindestens 1).
updated_atdate-timepflichtpaginationBlaetterinfopflichtDer pagination-Block, der bei JEDER Liste gleich aussieht.
has_morebooleanpflichtEs gibt eine weitere Seite. Dann steht next_starting_after dabei.
limitintegerpflichtnext_starting_afterstringCursor für die nächste Seite — unverändert als starting_after mitschicken. Fehlt das Feld, ist der Durchgang fertig.
offsetintegerpflichttotalintegerGesamtzahl der Treffer. Nur vorhanden, wenn include_total=true.
detailarray of ValidationErrorctxContextinputInputlocarray of string | integerpflichtmsgstringpflichttypestringpflichtSprache
Nur in diesem Browser, nur für „Ausprobieren“ — der Wert wird nicht gespeichert und nicht an uns geschickt.
curl -X GET 'https://open-api.mynextdays.com/v1/properties' \
-H 'Authorization: Bearer <access_token>'Ohne Token antwortet der Aufruf mit 401 — das ist der erwartete Weg.
{
"data": [
{
"id": "…",
"title": "…",
"status": "draft",
"currency": "…",
"max_guests": 1,
"units_total": 1,
"address": {},
"channels": {},
"created_at": "2026-09-10T14:00:00Z",
"updated_at": "2026-09-10T14:00:00Z"
}
],
"pagination": {
"limit": 1,
"offset": 1,
"has_more": false
}
}