Skip to main content
GET
/
hotels
List hotels
curl --request GET \
  --url https://api.valpas.io/hotels \
  --header 'x-api-key: <api-key>'
[
  {
    "id": "hotel_abc123",
    "name": "Grand Helsinki Hotel",
    "address": "Mannerheimintie 1, 00100 Helsinki",
    "latitude": 60.1699,
    "longitude": 24.9384,
    "language": "fi",
    "room_count": 85,
    "certified": true
  }
]

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
limit
integer
default:20

Maximum number of hotels to return (default: 20, max: 100)

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

Number of hotels to skip for pagination (default: 0)

Required range: x >= 0

Response

A list of hotels

​
id
string
required

Unique hotel identifier

Example:

"hotel_abc123"

​
name
string
required

Hotel name

Example:

"Grand Helsinki Hotel"

​
language
string
required

Primary language at the hotel (ISO 639-1 code)

Example:

"fi"

​
certified
boolean
required

Whether the hotel holds a current Valpas certification

Example:

true

​
address
string | null

Street address of the hotel

Example:

"Mannerheimintie 1, 00100 Helsinki"

​
latitude
number | null

Geographic latitude in decimal degrees

Example:

60.1699

​
longitude
number | null

Geographic longitude in decimal degrees

Example:

24.9384

​
room_count
integer | null

Total number of rooms (computed field; null if not configured)

Example:

85