Skip to main content
GET
/
hotels
/
{id}
Get hotel by ID
curl --request GET \
  --url https://api.valpas.io/hotels/{id} \
  --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

Path Parameters

​
id
string
required

Unique hotel identifier

Example:

"hotel_abc123"

Response

Hotel found

​
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