Skip to main content

​
Authenticate

​
1. Get your public key

Every distribution channel in SpaPortal has its own public key that identifies your channel and scopes all requests to it. To find yours, go to: Administration → Distribution Channel → [your channel] → Channel detail → Public keys

​
2. Use public key

Pass the public key in the X-SpaPortal-Public-Key header on every request: 
X-SpaPortal-Public-Key: pk_live_...

Authentication

Full authentication reference.

​
Make your first request

The base URL for the current API (v2) is: 
https://spaportal.cz/api/v2
Fetch a list of hotels: 
curl \
  -H "X-SpaPortal-Public-Key: pk_live_..." \
  "https://spaportal.cz/api/v2/hotels"
Example response: 
{
  "data": [
    {
      "id": "66f16191f739705faa020001",
      "name": { "cs-CZ": "Lázně Aurora", "de": "Aurora Spa" },
      "stars": 4
    }
  ],
  "pagination": { "limit": 25, "nextCursor": null, "hasMore": false, "total": 42 }
}

​
Next steps

You’re authenticated and making requests. Follow the API reference for all endpoints:

API Reference

All endpoints, parameters, and response shapes.