Skip to main content
GET
/
v1
/
running
/
year
/
{year}
Year in review
curl --request GET \
  --url https://api.rewind.rest/v1/running/year/{year} \
  --header 'Authorization: Bearer <token>'
{
  "year": 2025,
  "total_runs": 120,
  "total_distance_mi": 540.2,
  "total_elevation_ft": 18500,
  "total_duration_s": 257400,
  "avg_pace": "7:55/mi",
  "longest_run_mi": 13.1,
  "race_count": 3,
  "monthly": [
    {
      "month": "2025-01",
      "runs": 8,
      "distance_mi": 35.2,
      "duration_s": 17100,
      "elevation_ft": 1200
    },
    {
      "month": "2025-02",
      "runs": 10,
      "distance_mi": 42.1,
      "duration_s": 20400,
      "elevation_ft": 1500
    }
  ],
  "top_runs": [
    {
      "id": 12345,
      "strava_id": 12345,
      "name": "Portland Half Marathon",
      "date": "2025-10-06",
      "distance_mi": 13.1,
      "duration": "1:45:00",
      "duration_s": 6300,
      "pace": "8:01/mi",
      "elevation_ft": 320,
      "heartrate_avg": 160,
      "heartrate_max": 178,
      "cadence": 77,
      "calories": 1400,
      "suffer_score": 120,
      "city": "Portland",
      "state": "OR",
      "polyline": null,
      "is_race": true,
      "workout_type": "race",
      "strava_url": "https://www.strava.com/activities/12345"
    }
  ]
}

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.

Authorizations

Authorization
string
header
required

API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.

Path Parameters

year
string
required

Response

Year in review

year
number
required
total_runs
number
required
total_distance_mi
number
required
total_elevation_ft
number
required
total_duration_s
number
required
avg_pace
string
required
longest_run_mi
number
required
race_count
number
required
monthly
object[]
required
top_runs
object[]
required