Preise

Preisvorschau für einen Aufenthalt

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

Rechnet den Aufenthaltspreis mit allen Positionen.

Der Kanal ist fest direct: über diese API angefragte Preise sind die des Betriebs. Ein Kanal-Markup, das nur ein Portal betrifft, hier wählbar zu machen, hiesse einem Client zu erlauben, sich den günstigsten Kanal auszurechnen.

Query-Parameter

property_idstringpflicht

Objekt, für das gerechnet wird.

check_indatepflicht

Anreisetag.

check_outdatepflicht

Abreisetag — die Nacht davor ist die letzte.

guestsintegerStandard 1

Zahl der Gäste.

petsintegerStandard 0

Mitgebrachte Tiere. Preiswirksam in zwei Richtungen: eine Gebühr „pro Tier und Aufenthalt“ multipliziert damit, und jede Haustiergebühr — auch eine Pauschale — entfällt ohne Tier.

localestringStandard en

Sprache der Bezeichnungen in der Aufschlüsselung (ISO 639-1, z. B. „da“). Reine Anzeige-Achse — die Beträge sind unberührt. Ohne Angabe Englisch; pflegt der Betrieb die Sprache an einem Posten nicht, greift ebenfalls Englisch.

rate_plan_idstring

Der konkrete Rate-Plan. Beim Hotel entscheidend (BAR und B&B kosten verschieden); bei einem Ferienobjekt mit genau einem Rate-Plan kann er weggelassen werden.

promo_codestring

Aktionscode des Gastes. Er ist nur ein FILTER auf die Aktionen des Objekts — der Rabatt wird serverseitig gerechnet, ein Betrag aus dem Aufruf wird nie übernommen.

Antworten

200Successful Response

check_indatepflicht

check_outdatepflicht

currencystringpflicht

Währung des Objekts. Nie erfunden — fehlt sie, schlägt der Aufruf fehl.

guestsintegerpflicht

itemsarray of PreisvorschauPostenpflicht

amountstringpflicht

Betrag in der Währung des Objekts.

kindstringpflicht

Art der Position: lodging (Übernachtung), surcharge (Aufschlag), fee (Gebühr), discount (Rabatt, negativ), tax (Abgabe), addon (Zusatzleistung).

labelstringpflicht

Bezeichnung, wie der Gast sie sieht.

nightly_totalstringpflicht

Summe der Übernachtungen ohne Gebühren, Rabatte und Abgaben.

nightsintegerpflicht

petsintegerpflicht

promo_code_appliedbooleanpflicht

Hat der mitgeschickte Aktionscode WIRKLICH eine Aktion ausgelöst? false bei ungültigem Code — auch dann kann eine automatische Aktion gegriffen haben, sichtbar als discount-Position.

property_idstringpflicht

rate_plan_idstring

total_amountstringpflicht

Endsumme über alle Positionen.

404Das Objekt gibt es nicht oder der Zugang darf es nicht.

422Der Zeitraum ist unmöglich oder zu lang, die Gästezahl übersteigt die Kapazität, oder das Objekt hat für diese Tage keinen Preis.

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/quote?property_id=%3Cproperty_id%3E&check_in=%3Ccheck_in%3E&check_out=%3Ccheck_out%3E' \
  -H 'Authorization: Bearer <access_token>'

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

Beispiel

{
  "property_id": "…",
  "check_in": "2026-09-10",
  "check_out": "2026-09-10",
  "nights": 1,
  "guests": 1,
  "pets": 1,
  "currency": "…",
  "nightly_total": "…",
  "total_amount": "…",
  "promo_code_applied": false,
  "items": [
    {
      "kind": "…",
      "label": "…",
      "amount": "…"
    }
  ]
}