Objekte

Ein Objekt lesen

gethttps://open-api.mynextdays.com/v1/properties/{property_id}

Ein Objekt samt Adresse, Ausstattung und Kanal-Sichtbarkeit.

Prüft dieselbe Objekt-Beschränkung wie die Liste — ein Detailpfad, der nur den Mandanten prüft, wäre ein Weg an der Beschränkung vorbei (Wurzel 9).

Pfad-Parameter

property_idstringpflicht

Antworten

200Successful Response

addressAddresspflicht

Adresse in Einzelfeldern (street, house_number, postal_code, city, country).

amenitiesarray of string

building_idstring

Gebäude, unter dem dieses Objekt bei den Portalen geführt wird. Mehrere Objekte desselben Gebäudes teilen dort eine Kennung.

category_slugstring

channelsChannelspflicht

Kanal-Sichtbarkeit, je Kanal einzeln: marketplace (myBestDays), website (eigene Seite). Es gibt kein globales „veröffentlicht-Flag.

created_atdate-timepflicht

currencystringpflicht

Währungscode (ISO 4217) dieses Objekts.

idstringpflicht

latnumber

listing_typestring

entire_place | private_room | shared_room.

lngnumber

max_guestsintegerpflicht

photosarray of string

property_typestring

statusstringpflicht

Nur active ist verkäuflich. draft ist unfertig, inactive aus dem Verkauf genommen.

Erlaubt:draftactiveinactive

subtype_slugstring

timezonestring

Zeitzone des Objekts (IANA). Kalendertage beziehen sich darauf.

titlestringpflicht

units_totalintegerpflicht

Zahl der Einheiten dieses Typs (mindestens 1).

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

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

Beispiel

{
  "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"
}