v2

latestOpenAPI 3.1.02026-07-264221.0 KB

Batch fetch hotels by Netstorming IDs

Returns multiple hotels matching the provided Netstorming IDs. Maximum 1000 IDs per request. Hotels without a matching Netstorming ID are omitted from the response.

post/hotels/netstorming/batch

Request body

netstorming_idsstring[] required

Array of Netstorming IDs to look up (max 1000)

Example request

{
  "netstorming_ids": [
    "45373",
    "63148"
  ]
}

Response

List of matching hotels

idstring required

Unique hotel identifier

namestring required

Hotel name

descriptionstring nullable required

Marketing description of the hotel (null if not available)

addressstring nullable

Street address of the hotel

postal_codestring nullable required

Postal code (null if not available)

citystring nullable required

City name (null if not available)

country_codestring nullable required

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

latitudenumber nullable

Geographic latitude in decimal degrees

longitudenumber nullable

Geographic longitude in decimal degrees

languagestring nullable required

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

star_ratingnumber nullable required

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

room_countinteger nullable

Total number of rooms (null if not configured)

website_urlstring uri nullable required

Hotel website URL (null if not available)

emailstring email nullable required

Hotel reception email address (null if not available)

certifiedboolean required

Whether the hotel holds a current Valpas certification

certified_fromstring date nullable required

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

certified_untilstring date nullable required

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

certification_urlstring uri nullable required

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

netstorming_idstring nullable required

Netstorming integration identifier

Example response

[
  {
    "id": "00391351-e308-4aae-8b66-d868ebb37ff3",
    "name": "Grand Helsinki Hotel",
    "description": "A refined stay in the heart of Helsinki, steps from the central railway station.",
    "address": "Mannerheimintie 1, 00100 Helsinki",
    "postal_code": "00100",
    "city": "Helsinki",
    "country_code": "FI",
    "latitude": 60.1699,
    "longitude": 24.9384,
    "language": "fi",
    "star_rating": 4.5,
    "room_count": 85,
    "website_url": "https://www.grandhelsinkihotel.com",
    "email": "reception@grandhelsinkihotel.com",
    "images": [
      {
        "url": "https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/1.jpg",
        "caption": "Great Room Lobby"
      }
    ],
    "certified": true,
    "certified_from": "2026-01-15",
    "certified_until": "2026-03-30",
    "certification_url": "https://valpashotels.com",
    "netstorming_id": "45373"
  }
]