Running

Year in review

GET https://api.rewind.rest/v1/running/year/{year}

Returns a year-in-review summary with monthly breakdown and top runs.

Authorization

Authorizationheaderstringrequired

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

Path Parameters

yearpathstringrequired

Response

application/json

Year in review

yearnumberrequired

total_runsnumberrequired

total_distance_minumberrequired

total_elevation_ftnumberrequired

total_duration_snumberrequired

avg_pacestringrequired

longest_run_minumberrequired

race_countnumberrequired

monthlyarray of objectrequired

properties

top_runsarray of objectrequired

properties

cURL

curl -X GET 'https://api.rewind.rest/v1/running/year/{year}' \
  -H 'Authorization: Bearer <token>'

200

{
  "year": 0,
  "total_runs": 0,
  "total_distance_mi": 0,
  "total_elevation_ft": 0,
  "total_duration_s": 0,
  "avg_pace": "string",
  "longest_run_mi": 0,
  "race_count": 0,
  "monthly": [
    {
      "month": "string",
      "runs": 0,
      "distance_mi": 0,
      "duration_s": 0,
      "elevation_ft": 0
    }
  ],
  "top_runs": [
    {
      "id": 0,
      "strava_id": 0,
      "name": "string",
      "sport_type": "string",
      "date": "string",
      "distance_mi": 0,
      "duration": "string",
      "duration_s": 0,
      "pace": "string",
      "elevation_ft": 0,
      "heartrate_avg": 0,
      "heartrate_max": 0,
      "cadence": 0,
      "calories": 0,
      "suffer_score": 0,
      "city": "string",
      "state": "string",
      "start_lat": 0,
      "start_lng": 0,
      "polyline": "string",
      "is_race": true,
      "workout_type": "string",
      "strava_url": "string"
    }
  ]
}