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

# Quickstart

> Make your first authenticated API call in a few minutes.

Rewind is a hosted API, so there is nothing to install or run. With an API key you can make your first call in a couple of minutes.

<Note>
  You need a Rewind API key (`rw_live_...`). See
  [Authentication](/authentication) to create one and for the read-versus-admin
  key types.
</Note>

<Steps titleSize="h3">
  <Step title="Check the API is up">
    The health endpoint needs no authentication, so it is the simplest way to
    confirm you can reach the API.

    ```bash theme={null}
    curl https://api.rewind.rest/v1/health
    ```

    ```json theme={null}
    { "status": "ok", "timestamp": "2026-03-18T21:00:00.000Z" }
    ```
  </Step>

  <Step title="Make your first authenticated call">
    Every other endpoint takes your key as a Bearer token in the `Authorization`
    header. Fetch your most recent scrobbles:

    ```bash theme={null}
    curl -H "Authorization: Bearer rw_live_..." \
      "https://api.rewind.rest/v1/listening/recent?limit=5"
    ```

    ```json theme={null}
    {
      "data": [
        {
          "track": { "id": 4296, "name": "Cherry" },
          "artist": { "id": 551, "name": "Ratatat" },
          "album": { "id": 1566, "name": "Ratatat" },
          "scrobbled_at": "2026-03-18T01:14:04.000Z"
        }
      ]
    }
    ```
  </Step>

  <Step title="Try another domain">
    Every domain answers on the same `/v1/<domain>/...` shape. Pull your lifetime
    running stats:

    ```bash theme={null}
    curl -H "Authorization: Bearer rw_live_..." \
      https://api.rewind.rest/v1/running/stats
    ```

    ```json theme={null}
    {
      "data": {
        "total_runs": 1350,
        "total_distance_mi": 6069.88,
        "avg_pace": "8:12/mi",
        "years_active": 17
      }
    }
    ```
  </Step>

  <Step title="Page and filter results">
    List endpoints return a `{ data, pagination }` envelope and accept `page` and
    `limit`. Most list and stats endpoints also accept `date`, `from`, and `to`
    filters.

    ```bash theme={null}
    curl -H "Authorization: Bearer rw_live_..." \
      "https://api.rewind.rest/v1/listening/recent?from=2026-01-01&limit=10"
    ```
  </Step>
</Steps>

From here, browse the full [OpenAPI spec](/openapi-spec) to generate a client, or [use Rewind from Claude](/mcp/overview) through the MCP server.