Skip to main content
POST
/
hotels
/
netstorming
/
batch
Batch fetch hotels by Netstorming IDs
curl --request POST \
  --url https://connect.valpashotels.com/hotels/netstorming/batch \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "netstorming_ids": [
    "NS-12345",
    "NS-67890"
  ]
}
'
[
  {
    "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

Body

application/json
​
netstorming_ids
string[]
required

Array of Netstorming IDs to look up (max 1000)

Example:
["NS-12345", "NS-67890"]

Response

List of matching 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