Create or replace LOS data for an apartment

Holidu calls this endpoint to push the complete LOS data for an apartment to the affiliate.

This is an idempotent upsert (RFC 9110 §9.3.4):

  • If the affiliate does not yet have LOS data for this apartment, it should store the payload and respond with 201 Created.
  • If LOS data already exists, the affiliate should fully replace it with the provided payload and respond with 204 No Content.

The request body always contains the complete LOS dataset for the apartment. Any check-in dates the affiliate previously stored but that are absent from this payload are no longer valid and must be removed.

An empty los map ({}) means no pricing is available for the apartment — the affiliate should remove all stored LOS data for it.

Authentication

Holidu authenticates to the affiliate using an OAuth 2.0 Bearer Token (RFC 6750).

PropertyValue
Typehttp
Schemebearer
Bearer formatJWT

Token exchange details are agreed upon during onboarding.

Request body examples

Multiple check-in dates with tiered pricing:

{
  "los": {
    "2024-06-01": [
      { "currency": "EUR", "guests": 2, "price": [0, 0, 300.00, 400.00, 500.00] },
      { "currency": "EUR", "guests": 4, "price": [0, 0, 350.00, 460.00, 580.00] }
    ],
    "2024-06-02": [
      { "currency": "EUR", "guests": 2, "price": [0, 150.00, 280.00] }
    ]
  }
}

Single check-in date with one pricing tier:

{
  "los": {
    "2024-06-01": [
      { "currency": "EUR", "guests": 2, "price": [0, 0, 300.00, 400.00, 500.00] }
    ]
  }
}

Empty LOS (no pricing available / fully booked):

{ "los": {} }
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Holidu's unique identifier for the apartment. This ID is stable and assigned during onboarding.

Body Params

The Length of Stay (LOS) represents accumulated prices per check-in date and length of stay. If the map is empty, no pricing is available for the apartment.

los
object
required

The key is an ISO calendar date (YYYY-MM-DD) representing the check-in date. The value is a list of price configurations for that date. A single check-in date may have multiple entries with different guest counts, each representing a separate pricing tier.

Responses

204

LOS data replaced successfully — no response body (RFC 9110 §15.3.5).

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
*/*
application/problem+json