GET /api/mcp/best-efforts

GET /api/mcp/best-efforts
Authorization: Bearer <api-key>

Returns all-time best mean-maximal power (MMP) records rolled up across all matching activities, plus the per-activity breakdown. For each standard duration, all_time_best contains the highest power ever recorded in any activity within the date range.

See Best Efforts (MMP) for methodology.

Query parameters

Parameter	Type	Required	Description
sport	string	No	Sport to filter by (default: cycling)
from	string	No	Only consider activities on or after this date
to	string	No	Only consider activities on or before this date

Response

HTTP 200

{
  "sport": "cycling",
  "from": "2025-01-01",
  "to": "2025-03-31",
  "all_time_best": {
    "p5s": 920,
    "p10s": 840,
    "p30s": 620,
    "p1m": 520,
    "p2m": 460,
    "p5m": 380,
    "p10m": 340,
    "p20m": 312,
    "p60m": 268
  },
  "per_activity": [
    {
      "id": "a1b2c3d4-...",
      "started_at": "2025-03-15T07:30:00Z",
      "best_efforts": {
        "p5s": 820,
        "p1m": 480,
        "p5m": 360,
        "p20m": 305
      }
    }
  ]
}

Duration keys: p5s (5 sec), p10s, p30s, p1m, p2m, p5m, p10m, p20m, p60m — values are best average power in watts. A key is omitted from all_time_best if no activity in the range has data for that duration.

Example

# All-time cycling bests
curl "https://mydatafor.life/api/mcp/best-efforts" \
  -H "Authorization: Bearer $FITREPO_API_KEY"

# Running bests in the last 90 days
curl "https://mydatafor.life/api/mcp/best-efforts?sport=running&from=2025-01-01&to=2025-03-31" \
  -H "Authorization: Bearer $FITREPO_API_KEY"