Get calendar dates in bulk

curl --request POST \
  --url https://spaportal.cz/api/v2/calendar/dates/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-SpaPortal-Public-Key: <api-key>' \
  --data '
{
  "items": [
    {
      "visitTypeId": "<string>",
      "hotelId": "<string>",
      "roomTypeId": "<string>",
      "destinationId": "<string>",
      "guests": 1,
      "dateFrom": "2023-12-25",
      "dateTo": "2023-12-25",
      "key": "<string>"
    }
  ],
  "shared": {
    "visitTypeId": "<string>",
    "hotelId": "<string>",
    "roomTypeId": "<string>",
    "destinationId": "<string>",
    "guests": 1,
    "dateFrom": "2023-12-25",
    "dateTo": "2023-12-25"
  }
}
'

{
  "results": [
    {
      "key": "<string>",
      "data": [
        {
          "date": "2023-12-25",
          "selectable": true,
          "price": {
            "isFinal": true,
            "amounts": {
              "CZK": {
                "amountMinor": 180000
              },
              "EUR": {
                "amountMinor": 180000
              }
            }
          }
        }
      ]
    }
  ]
}

Availability

Get calendar dates in bulk

Returns availability and prices for multiple calendar queries in one request.

Put values common to all items in shared; set only the differences per item. Each item’s effective query resolves like this:

Case	Result
Field omitted from the item	The `shared` value is used.
Field set on the item	The item value overrides `shared`.
Field set to `null` on the item	`null` is used; `shared` is ignored.
Field missing from both	`null` is used.

Results are returned one per item, in request order; key is echoed when supplied. price.amounts includes every currency that has a price for the date - a currency with no price is omitted.

If any item fails, the whole request fails (no partial results); the error details name the failing item index and key.

POST

calendar

dates

bulk

Get calendar dates in bulk

curl --request POST \
  --url https://spaportal.cz/api/v2/calendar/dates/bulk \
  --header 'Content-Type: application/json' \
  --header 'X-SpaPortal-Public-Key: <api-key>' \
  --data '
{
  "items": [
    {
      "visitTypeId": "<string>",
      "hotelId": "<string>",
      "roomTypeId": "<string>",
      "destinationId": "<string>",
      "guests": 1,
      "dateFrom": "2023-12-25",
      "dateTo": "2023-12-25",
      "key": "<string>"
    }
  ],
  "shared": {
    "visitTypeId": "<string>",
    "hotelId": "<string>",
    "roomTypeId": "<string>",
    "destinationId": "<string>",
    "guests": 1,
    "dateFrom": "2023-12-25",
    "dateTo": "2023-12-25"
  }
}
'

{
  "results": [
    {
      "key": "<string>",
      "data": [
        {
          "date": "2023-12-25",
          "selectable": true,
          "price": {
            "isFinal": true,
            "amounts": {
              "CZK": {
                "amountMinor": 180000
              },
              "EUR": {
                "amountMinor": 180000
              }
            }
          }
        }
      ]
    }
  ]
}

Authorizations

X-SpaPortal-Public-Key

string

header

required

Headers

X-Request-Id

string

Optional client-provided request identifier echoed in error responses.

Body

application/json

items

object[]

required

Required array length: 1 - 20 elements

Show child attributes

shared

object

Show child attributes

Response

Calendar date results for each item.

results

object[]

Show child attributes

Versioning List room types