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.
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": {
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.