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 to create one and for the read-versus-admin key types.

Check the API is up

The health endpoint needs no authentication, so it is the simplest way to confirm you can reach the API.

curl https://api.rewind.rest/v1/health

{ "status": "ok", "timestamp": "2026-03-18T21:00:00.000Z" }

Make your first authenticated call

Every other endpoint takes your key as a Bearer token in the Authorization header. Fetch your most recent scrobbles:

curl -H "Authorization: Bearer rw_live_..." \
  "https://api.rewind.rest/v1/listening/recent?limit=5"

{
  "data": [
    {
      "track": { "id": 4296, "name": "Cherry" },
      "artist": { "id": 551, "name": "Ratatat" },
      "album": { "id": 1566, "name": "Ratatat" },
      "scrobbled_at": "2026-03-18T01:14:04.000Z"
    }
  ]
}

Try another domain

Every domain answers on the same /v1/<domain>/... shape. Pull your lifetime running stats:

curl -H "Authorization: Bearer rw_live_..." \
  https://api.rewind.rest/v1/running/stats

{
  "data": {
    "total_runs": 1350,
    "total_distance_mi": 6069.88,
    "avg_pace": "8:12/mi",
    "years_active": 17
  }
}

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.

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 to generate a client, or use Rewind from Claude through the MCP server.

Getting Started

Domains

Help

Check the API is up

Make your first authenticated call

Try another domain

Page and filter results