v2

latestOpenAPI 3.1.02026-07-264221.0 KB

List hotels

Returns a paginated list of hotels accessible with your API key.

get/hotels

Query parameters

limitinteger

Maximum number of hotels to return (default: 20, max: 100)

offsetinteger

Number of hotels to skip for pagination (default: 0)

Response

A list of 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"
  }
]