Quickstart - Valpas API

Understand the response

A successful request returns an array of hotel objects:

[
  {
    "id": "00391351-e308-4aae-8b66-d868ebb37ff3",
    "name": "Paris Marriott Rive Gauche Hotel & Conference Center",
    "description": "Surrounded by diverse attractions, Paris Marriott Rive Gauche Hotel is a stylish haven in an iconic travel destination.",
    "address": "17 Boulevard Saint Jacques, 75014 Paris France",
    "postal_code": "75014",
    "city": "Paris",
    "country_code": "FR",
    "latitude": 48.831917,
    "longitude": 2.340172,
    "language": null,
    "star_rating": null,
    "room_count": null,
    "website_url": "https://www.marriott.com/en-us/hotels/parst-paris-marriott-rive-gauche-hotel-and-conference-center/overview/",
    "email": null,
    "images": [
      {
        "url": "https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/1.jpg",
        "caption": "Great Room Lobby"
      },
      {
        "url": "https://misxceaqoppcaiaitpkj.supabase.co/storage/v1/object/public/hotel-images/00391351-e308-4aae-8b66-d868ebb37ff3/2.jpg",
        "caption": "Palyma Bar"
      }
    ],
    "certified": true,
    "certified_from": null,
    "certified_until": null,
    "certification_url": "https://valpashotels.com",
    "netstorming_id": "45373",
    "giata_id": 99999999
  }
]

Key fields include:

description — marketing description of the hotel (null if not available)
postal_code / city / country_code — structured location details; country_code is ISO 3166-1 alpha-2
star_rating — official hotel star rating (null if not available)
website_url — hotel website (null if not available)
email — hotel reception email address (null if not available)
images — up to 3 hotel photos with captions (empty array if none)
certified — whether the hotel holds a current Valpas certification
certified_from / certified_until — certification validity period (null if not set)
certification_url — link target for the certification badge (null when not certified)
netstorming_id — Netstorming integration identifier
giata_id — GIATA MultiCodes property identifier, an integer (null if the hotel is not mapped or your API key lacks the giata scope)

See the API Reference for the full field descriptions.

Authentication

API Reference