Stride

Search Documentation

Search for articles, guides, and more

← API overview

List the athlete's teams

GET/v1/teamsrequires teams.read

Every team the athlete belongs to, with their role in each, plus every sub-team beneath the ones they coach. Teams form a tree and a role held on a team applies to all of its sub-teams.

This is the discovery path for coach access: teams with can_manage: true are ones the athlete coaches or administers, and every member of those teams is an athlete_id this token may pass to the other endpoints.

Query parameters

  • roleenum

    Only teams where the athlete holds this role.

    ADMIN · COACH · MEMBER

Example

bash
curl -X GET "https://api.stride.is/v1/teams" \
  -H "Authorization: Bearer $STRIDE_TOKEN"

Response 200

Success.

  • teamsobject[]always present
    • can_managebooleanalways present
    • created_atstringalways present
    • depthintegeralways present
    • header_image_urlstring
    • idstringalways present
    • inherited_fromstring
    • logo_urlstring
    • membersobject[]
      • created_atstring
      • rolestringalways present
      • team_idstring
      • team_namestring
      • userobjectalways present
    • namestringalways present
    • parent_idstring
    • partnerbooleanalways present
    • rolestring
    • root_idstring
    • slugstringalways 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.