Stride

Search Documentation

Search for articles, guides, and more

← API overview

Get the metric in effect at a point in time

GET/v1/athletes/{athlete_id}/metrics/{metric_type}/currentrequires metrics.read

The most recent reading of one metric on or before at, which is the value that actually applied then.

This is how to get the FTP an old session was ridden against rather than today's. Returns 404 when the athlete has no reading on or before that date.

Path parameters

  • athlete_idstringrequired

    The athlete to act on. `me` is the athlete who authorized this token; any other ID must be an athlete they coach.

  • metric_typestringrequired

    The metric to read, e.g. `FTP`, `WEIGHT`, `THRESHOLD_HEART_RATE`.

Query parameters

  • atstring

    Point in time to read the metric as of, RFC 3339 or YYYY-MM-DD. Defaults to now.

    e.g. 2026-06-01

Example

bash
curl -X GET "https://api.stride.is/v1/athletes/{athlete_id}/metrics/{metric_type}/current" \
  -H "Authorization: Bearer $STRIDE_TOKEN"

Response 200

Success.

  • metricobject
    • sourcestring

      Where the reading came from, e.g. the provider that reported it or MANUAL when the athlete entered it.

    • timestampstring

      When the reading was taken.

    • typestringalways present

      The metric, e.g. FTP, WEIGHT, THRESHOLD_HEART_RATE.

    • valuenumberalways present

      The reading. Units follow the type: watts for power, kilograms for weight, bpm for heart rate, seconds per kilometre for pace.

  • typestringalways present

Errors

Every error is an RFC 9457 problem document. Branch on its code, which is stable; detail is prose and may be reworded.

  • 400The request was malformed: an unparseable date, an unknown enum value, or a parameter combination that cannot be satisfied.
  • 401No access token was supplied, or it is not valid for this API.
  • 402The Stride account the token belongs to has no active subscription or trial.
  • 403The token does not hold the scope this endpoint requires, or may not act on the athlete or team named.
  • 404No such resource, or it is not visible to this token. The two are deliberately indistinguishable.
  • 405The path exists but does not serve this method. The Allow header lists the ones it does.
  • 429A rate limit was exceeded. Retry after the period in the Retry-After header.
  • 500Something failed on Stride's side. The failure is logged with a trace ID.