Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.valpashotels.com/llms.txt

Use this file to discover all available pages before exploring further.

1

Get your API key

Email team@valpas.io to request an API key. You will receive your key by email.
Store your API key in an environment variable — never hardcode it in your application.
2

Make your first request

Call the GET /hotels endpoint with your API key in the x-api-key header:
curl https://connect.valpashotels.com/hotels \
  -H "x-api-key: YOUR_API_KEY"
3

Understand the response

A successful request returns an array of hotel objects:
[
  {
    "id": "hotel_abc123",
    "name": "Grand Helsinki Hotel",
    "address": "Mannerheimintie 1, 00100 Helsinki",
    "latitude": 60.1699,
    "longitude": 24.9384,
    "language": "fi",
    "room_count": 85,
    "certified": true,
    "certified_from": "2026-01-15",
    "certified_until": "2026-03-30",
    "netstorming_id": "NS-12345"
  }
]
Key fields include:
  • certified — whether the hotel holds a current Valpas certification
  • certified_from / certified_until — certification validity period
  • netstorming_id — Netstorming integration identifier
See the API Reference for the full field descriptions.
4

Next steps

Authentication

Learn how to use your API key and handle auth errors.

API Reference

Full endpoint documentation with interactive playground.