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

# Quickstart

> Make your first authenticated request against the Spirii Public API.

This quickstart walks you through making your first authenticated request.

<Steps>
  <Step title="Create an API key">
    Create an API key via Spirii Connect. Navigate to [API tokens](https://connect.spirii.com/team?activeTab=api_tokens\&limit=24\&page=1) under Team Access. Upon creation, you will receive your unique API key via a secure one-time link.

    This link can only be opened once, so ensure you store your key securely after accessing it.
  </Step>

  <Step title="Make your first request">
    Replace `YOUR_API_KEY` and run:

    <CodeGroup>
      ```bash curl theme={null}
      curl https://api.spirii.com/v1/locations \
        -H "Authorization: Bearer YOUR_API_KEY"
      ```

      ```javascript Node.js theme={null}
      const res = await fetch("https://api.spirii.com/v1/locations", {
        headers: { Authorization: `Bearer ${process.env.SPIRII_API_KEY}` },
      });
      console.log(await res.json());
      ```

      ```python Python theme={null}
      import os, requests

      r = requests.get(
          "https://api.spirii.com/v1/locations",
          headers={"Authorization": f"Bearer {os.environ['SPIRII_API_KEY']}"},
      )
      print(r.json())
      ```
    </CodeGroup>
  </Step>

  <Step title="Explore the API Reference">
    Every endpoint has a try-it playground. See [API Reference](/api-reference/overview).
  </Step>
</Steps>

<Warning>
  Only Spirii Connect users with an **Operator** role or higher can create API tokens.
</Warning>