Skip to main content
GET
/
hotels
List hotels
curl --request GET \
  --url https://connect.valpashotels.com/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,
    "certified_from": "2026-01-15",
    "certified_until": "2026-03-30",
    "netstorming_id": "NS-12345"
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.valpashotels.com/llms.txt

Use this file to discover all available pages before exploring further.

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

​
certified_from
string<date> | null
required

Date when the hotel's Valpas certification becomes valid (YYYY-MM-DD)

Example:

"2026-01-15"

​
certified_until
string<date> | null
required

Date when the hotel's Valpas certification expires (YYYY-MM-DD)

Example:

"2026-03-30"

​
netstorming_id
string | null
required

Netstorming integration identifier

Example:

"NS-12345"

​
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