Quickstart - SpaPortal Docs

Authenticate

1. Get your public key

Get a public key using the authentication instructions. The channels and scope reference explains which resources your key can access.

2. Use public key

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

X-SpaPortal-Public-Key: <your_public_key>

Authentication

Full authentication reference.

Make your first request

The base URL for the v2 catalog is:

https://spaportal.cz/api/v2

Fetch a list of hotels:

curl \
  -H "X-SpaPortal-Public-Key: <your_public_key>" \
  -H "Accept-Language: cs-CZ,de" \
  "https://spaportal.cz/api/v2/hotels"

Example response (abridged):

{
  "data": [
    {
      "id": "66f16191f739705faa020001",
      "name": { "cs-CZ": "Lázně Aurora", "de": "Aurora Spa" },
      "stars": 4
    }
  ],
  "pagination": { "limit": 25, "nextCursor": null, "hasMore": false, "total": 1 }
}

Next steps

Continue with the catalog endpoints and their response objects. Check API coverage for the status of each resource.

API Reference

All endpoints, parameters, and response shapes.

​Authenticate

​1. Get your public key

​2. Use public key