Skip to main content
POST
Batch fetch hotels by Netstorming IDs

Authorizations

x-api-key
string
header
required

Body

application/json
netstorming_ids
string[]
required

Array of Netstorming IDs to look up (max 1000)

Example:

Response

List of matching hotels

id
string
required

Unique hotel identifier

Example:

"00391351-e308-4aae-8b66-d868ebb37ff3"

name
string
required

Hotel name

Example:

"Grand Helsinki Hotel"

description
string | null
required

Marketing description of the hotel (null if not available)

Example:

"A refined stay in the heart of Helsinki, steps from the central railway station."

postal_code
string | null
required

Postal code (null if not available)

Example:

"00100"

city
string | null
required

City name (null if not available)

Example:

"Helsinki"

country_code
string | null
required

Country code (ISO 3166-1 alpha-2, null if not available)

Example:

"FI"

language
string | null
required

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

Example:

"fi"

star_rating
number | null
required

Official hotel star rating, e.g. 4 or 4.5 (null if not available)

Example:

4.5

website_url
string<uri> | null
required

Hotel website URL (null if not available)

Example:

"https://www.grandhelsinkihotel.com"

email
string<email> | null
required

Hotel reception email address (null if not available)

Example:

"reception@grandhelsinkihotel.com"

images
object[]
required

Hotel photos (up to 3), served from the Valpas CDN. Empty array if no photos are available.

Example:
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"

certification_url
string<uri> | null
required

Link target for the Valpas certification badge (null when the hotel is not certified)

Example:

"https://valpashotels.com"

netstorming_id
string | null
required

Netstorming integration identifier

Example:

"45373"

giata_id
integer | null
required

GIATA MultiCodes property identifier (null if the hotel is not mapped to a GIATA code, or if your API key lacks the giata scope)

Example:

99999999

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 (null if not configured)

Example:

85