> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spaportal.cz/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

## 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:

```bash theme={null}
X-SpaPortal-Public-Key: <your_public_key>
```

<Card title="Authentication" icon="key" horizontal href="/api/authentication">
  Full authentication reference.
</Card>

## Make your first request

The base URL for the current API (v2) is:

```text theme={null}
https://spaportal.cz/api/v2
```

Fetch a list of hotels:

```bash theme={null}
curl \
  -H "X-SpaPortal-Public-Key: <your_public_key>" \
  "https://spaportal.cz/api/v2/hotels"
```

**Example response (abridged):**

```json theme={null}
{
  "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:

<Card title="API Reference" icon="square-terminal" href="/api/">
  All endpoints, parameters, and response shapes.
</Card>