Skip to main content
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://api.valpas.io/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
  }
]
Each hotel object includes a certified field indicating whether the hotel holds a current Valpas certification. 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.