Skip to main content
​
API

​
GIATA MultiCodes lookup

Hotels can now be resolved by their GIATA MultiCodes property identifier.
  • giata_id — new field on the hotel object, returned by every endpoint. An integer, or null for hotels not yet mapped to a GIATA code.
  • GET /hotels/giata/{giataId} — fetch a single hotel by GIATA ID.
  • POST /hotels/giata/batch — fetch up to 1000 hotels by GIATA ID in one request. Accepts integers or integer-valued strings.
  • GET /hotels?giata_id= — filter the hotel list by GIATA ID.
Note that giata_id is an integer, unlike the string netstorming_id. A value that is not an integer returns 400 with {"error": "giata_id must be an integer"}.No breaking changes: all existing fields and endpoints are unchanged, and no request changes are needed to receive the new field.
​
API

​
Structured location, star rating, website, and contact fields

The hotel object returned by all endpoints now includes six new fields:
  • postal_code — postal code as a separate field (null if not available).
  • city — city name as a separate field (null if not available).
  • country_code — ISO 3166-1 alpha-2 country code, e.g. FI or FR (null if not available).
  • star_rating — official hotel star rating, e.g. 4 or 4.5. Currently null for all hotels; values will be populated progressively.
  • website_url — the hotel’s own website.
  • email — hotel reception email address. Currently null for all hotels; values will be populated progressively.
The existing address field is unchanged and still contains the full address string.No breaking changes: all existing fields are unchanged, and no request changes are needed to receive the new fields.
​
API
The hotel object returned by all endpoints now includes richer content:
  • description — a marketing description of the hotel (null if not available).
  • images — up to 3 photos per hotel as { url, caption } objects, served from the Valpas CDN. An empty array is returned when no photos are available.
  • certification_url — the link target for the Valpas certification badge. Read this field instead of hardcoding a URL; it is null for hotels without a current certification.
Additionally, room_count is now backed by dedicated hotel data and will be populated progressively — expect values to appear over time.No breaking changes: all existing fields are unchanged, and no request changes are needed to receive the new fields.
​
API

​
Public launch

The Valpas Public API is live at https://connect.valpashotels.com.
  • Authentication via the x-api-key header — request a key from team@valpas.io.
  • Endpoints: GET /hotels (paginated list), GET /hotels/{id}, GET /hotels/netstorming/{netstormingId}, and POST /hotels/netstorming/batch (up to 1000 IDs per request).
  • Hotel objects include location data, Valpas certification status with validity dates, and Netstorming integration identifiers.