Skip to main content
GET
/
visit-types
Get visit types
curl --request GET \
  --url https://spaportal.cz/api/v1/visit-types \
  --header 'Authorization: Bearer <token>'
[
  {
    "_id": "66f16191f739705faa020004",
    "id": 1,
    "priority_position": 1,
    "on_demand": false,
    "name": {
      "cs_CZ": "Frantiskolazenska lecebna kura",
      "de": "Franzensbader Heilkur"
    },
    "visit_type_categories": [
      {
        "_id": "66f16191f739705faa020005",
        "id": 1,
        "name": {
          "cs_CZ": "Lazensky pobyt",
          "de": "Heilkur"
        }
      }
    ],
    "booking_url": {
      "cs_CZ": "https://rezervace.frantiskovylazne.cz?visitType=Franzensbader%20Heilkur",
      "de": "https://reservierung.franzensbad.cz?visitType=Franzensbader%20Heilkur"
    },
    "description": {
      "cs_CZ": "Prohlidka lekarem a procedury podle zdravotniho stavu.",
      "de": "Kuraufenthalt mit aerztlicher Untersuchung."
    },
    "nights_min": 1,
    "nights_max": 3,
    "reservation_time_span": "DAYS",
    "time_constraints": [
      {
        "date_from": "2026-10-01",
        "date_to": "2026-12-01"
      }
    ],
    "procedures": 12,
    "procedure_frequency": "VISIT",
    "procedures_per_day": 4,
    "boarding": "HALF_BOARD",
    "available_boardings": [
      "HALF_BOARD",
      "FULL_BOARD",
      "BREAKFAST",
      "LUNCH",
      "DINNER",
      "ALL_INCLUSIVE"
    ],
    "tags": [
      {
        "_id": "66f16191f739705faa020006",
        "id": 1,
        "name": {
          "cs_CZ": "Byt stale mlad",
          "de": "Sei noch jung"
        },
        "color": "0000ff"
      }
    ],
    "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": ""
    },
    "notice": {
      "cs_CZ": "Cena bez rozdilu kategorie.",
      "de": ""
    },
    "services": {
      "cs_CZ": "14x ubytovani.",
      "de": "14x Unterkunft."
    },
    "hotels": [
      {
        "_id": "66f16191f739705faa020002",
        "id": 1,
        "name": "Pawlik",
        "lowest_price": {
          "cs_CZ": {
            "amount_per_night": 1024.5,
            "currency": "CZK"
          },
          "de": {
            "amount_per_night": 40,
            "currency": "EUR"
          }
        }
      }
    ],
    "loyalty_programs": [
      {
        "_id": "66f16191f739705faa020007",
        "id": 2,
        "name": {
          "cs_CZ": "VIP Club Premium",
          "de": "VIP Club Premium",
          "en": "VIP Club Premium"
        }
      }
    ]
  }
]

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
hotel_id
integer

Filter by hotel ID.

destination_id
integer

Filter by destination ID.

hotel_stars_min
integer

Minimum hotel star rating.

Required range: 1 <= x <= 5
hotel_stars_max
integer

Maximum hotel star rating.

Required range: 1 <= x <= 5
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.

nights_min
integer

Minimum number of nights.

nights_max
integer

Maximum number of nights.

Response

Visit types matching the filters.

_id
string

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

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

"66f16191f739705faa020001"

id
priority_position
integer
on_demand
boolean
name
object
Example:
{
"cs_CZ": "Frantiskovy Lazne",
"de": "Franzensbad"
}
visit_type_categories
object[]
booking_url
object
Example:
{
"cs_CZ": "Frantiskovy Lazne",
"de": "Franzensbad"
}
description
object
Example:
{
"cs_CZ": "Frantiskovy Lazne",
"de": "Franzensbad"
}
nights_min
integer
nights_max
integer
reservation_time_span
enum<string>
Available options:
DAYS,
WEEKS
time_constraints
object[]
procedures
integer
procedure_frequency
enum<string>
Available options:
DAY,
WEEK,
VISIT
procedures_per_day
integer
boarding
string
available_boardings
string[]
tags
object[]
lowest_price
object
commercial_slogan
object
Example:
{
"cs_CZ": "Frantiskovy Lazne",
"de": "Franzensbad"
}
notice
object
Example:
{
"cs_CZ": "Frantiskovy Lazne",
"de": "Franzensbad"
}
services
object
Example:
{
"cs_CZ": "Frantiskovy Lazne",
"de": "Franzensbad"
}
hotels
object[]
loyalty_programs
object[]