Source: https://dinakar-rewind.docs.pageloop.ai/quickstart

# Quickstart

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.

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

1. **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
   curl https://api.rewind.rest/v1/health
   ```
   ```json
   { "status": "ok", "timestamp": "2026-03-18T21:00:00.000Z" }
   ```
2. **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
   curl -H "Authorization: Bearer rw_live_..." \
     "https://api.rewind.rest/v1/listening/recent?limit=5"
   ```
   ```json
   {
     "data": [
       {
         "track": { "id": 4296, "name": "Cherry" },
         "artist": { "id": 551, "name": "Ratatat" },
         "album": { "id": 1566, "name": "Ratatat" },
         "scrobbled_at": "2026-03-18T01:14:04.000Z"
       }
     ]
   }
   ```
3. **Try another domain**

   Every domain answers on the same `/v1/<domain>/...` shape. Pull your lifetime
   running stats:
   ```bash
   curl -H "Authorization: Bearer rw_live_..." \
     https://api.rewind.rest/v1/running/stats
   ```
   ```json
   {
     "data": {
       "total_runs": 1350,
       "total_distance_mi": 6069.88,
       "avg_pace": "8:12/mi",
       "years_active": 17
     }
   }
   ```
4. **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
   curl -H "Authorization: Bearer rw_live_..." \
     "https://api.rewind.rest/v1/listening/recent?from=2026-01-01&limit=10"
   ```

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