Skip to main content
GET
/
hotels
Get hotels
curl --request GET \
  --url https://spaportal.cz/api/v1/hotels \
  --header 'Authorization: Bearer <token>'
[
  {
    "_id": "66f16191f739705faa020002",
    "id": 1,
    "name": "Pawlik",
    "stars": 4,
    "phone_number": "+420 354 201 111",
    "email": {
      "cs_CZ": "info@frantiskovylazne.cz",
      "de": "info@franzensbad.cz"
    },
    "description": {
      "cs_CZ": "Kralovska vila mesta Frantiskovy Lazne uprostred lazenskeho parku.",
      "de": "Die Koenigsvilla Franzensbads im Zentrum der Stadt."
    },
    "equipment": {
      "cs_CZ": "Hotel je vybaven moderni saunou.",
      "de": "Hotel hat eine Sauna."
    },
    "services": {
      "cs_CZ": "Kuryri sluzby v cene pobytu.",
      "de": "DHL included."
    },
    "lowest_price": {
      "cs_CZ": {
        "amount_per_night": 1024.5,
        "currency": "CZK"
      },
      "de": {
        "amount_per_night": 40,
        "currency": "EUR"
      }
    },
    "commercial_slogan": {
      "cs_CZ": "Buy it or leave it.",
      "de": ""
    },
    "image": "https://spaportal-files.s3.eu-central-1.amazonaws.com/production/hotels/example/pawlik.jpg",
    "thumbnail": "https://spaportal-files.s3.eu-central-1.amazonaws.com/production/thumbnails/hotels/example/pawlik.webp",
    "booking_url": {
      "cs_CZ": "https://rezervace.frantiskovylazne.cz?hotel=Pawlik",
      "de": "https://reservierung.franzensbad.cz?hotel=Pawlik"
    },
    "destination": {
      "_id": "66f16191f739705faa020001",
      "id": 1,
      "name": {
        "cs_CZ": "Frantiskovy Lazne",
        "de": "Franzensbad"
      }
    },
    "address": {
      "address_line": "Dr. Pohoreckeho 22",
      "city": "Frantiskovy Lazne",
      "postal_code": "351 01",
      "country_code": "CZE"
    },
    "roomTypes": [
      {
        "_id": "66f16191f739705faa020003",
        "id": 1,
        "category": {
          "cs_CZ": "Prezidentske apartma",
          "de": "App. Aquaforum"
        },
        "facilities": [
          "shower",
          "toilet",
          "bath"
        ],
        "beds": 2,
        "image": "https://spaportal-files.s3.eu-central-1.amazonaws.com/production/rooms/example/room.jpg",
        "thumbnail": "https://spaportal-files.s3.eu-central-1.amazonaws.com/production/thumbnails/rooms/example/room.webp",
        "booking_url": {
          "cs_CZ": "https://rezervace.frantiskovylazne.cz?hotel=Pawlik&roomType=APPARTEMENT",
          "de": "https://reservierung.franzensbad.cz?hotel=Pawlik&roomType=APPARTEMENT"
        },
        "description": {
          "cs_CZ": "Pokoj s koupelnou, sprchou, WC a fenem.",
          "de": "Luxurioeses Appartement."
        },
        "lowest_price": {
          "cs_CZ": {
            "amount_per_night": 1024.5,
            "currency": "CZK"
          },
          "de": {
            "amount_per_night": 40,
            "currency": "EUR"
          }
        }
      }
    ]
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Accept-Language
string

Comma-separated list of languages to include.

Example:

"cs_CZ,de"

Query Parameters

​
max
integer
default:10

Number of records to return.

Required range: 1 <= x <= 100
​
offset
integer
default:0

Number of records to skip.

Required range: x >= 0
​
destination_id
integer

Filter by destination ID.

​
visit_type_id
integer

Filter by visit type ID.

​
number_of_beds
integer

Filter by room occupancy.

Required range: x >= 1
​
date_from
string<date>

Start date in YYYY-MM-DD format.

​
date_to
string<date>

End date in YYYY-MM-DD format.

​
include_room_types
boolean
default:true

Include room types in the hotel response.

Response

Hotels matching the filters.

​
_id
string

Object id (24-character hex string) for the same entity.

Pattern: ^[0-9a-fA-F]{24}$
Example:

"66f16191f739705faa020001"

​
id
integer
​
name
string
​
stars
integer | null
​
address
object
​
phone_number
string
​
email
object
Example:
{
  "cs_CZ": "Frantiskovy Lazne",
  "de": "Franzensbad"
}
​
description
object
Example:
{
  "cs_CZ": "Frantiskovy Lazne",
  "de": "Franzensbad"
}
​
equipment
object
Example:
{
  "cs_CZ": "Frantiskovy Lazne",
  "de": "Franzensbad"
}
​
services
object
Example:
{
  "cs_CZ": "Frantiskovy Lazne",
  "de": "Franzensbad"
}
​
lowest_price
object
​
commercial_slogan
object
Example:
{
  "cs_CZ": "Frantiskovy Lazne",
  "de": "Franzensbad"
}
​
image
string | null
​
thumbnail
string | null
​
booking_url
object
Example:
{
  "cs_CZ": "Frantiskovy Lazne",
  "de": "Franzensbad"
}
​
destination
object
​
roomTypes
object[]