Teams

Position history

GET/v2/teams/{id}/position-historyAll plans

View as Markdown Try in Playground →

The team’s league position at the end of each week of one season, week 1 first, with the fixtures it played that week.

League competitions with a table only (no cups). A week without a match keeps the previous position.

Parameters

pathrequired

our numeric id (positive integer)

league

queryrequired

a league id (e.g. from /v2/teams/{id}/leagues)

season

queryrequired

a season id from /v2/leagues/{id}/seasons

Response

data: PositionHistoryPoint[]
meta: league, season, count
errors: 400 bad_request — missing or invalid league or season403 history_not_in_plan — the season ended before your plan’s history404 no_data — the source keeps no position history for that team, league and season (404 not_found: an id we never issued)404 not_found — season is not one of this league’s seasons (the message names the parameter; list them with /v2/leagues/{id}/seasons)

Every /v2 call can also answer the common errors.

Try it →

$ curl -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/v2/teams/{id}/position-history?league=…&season=…"

Example

{ "data": [ { "week": 1, "from": "2026-08-21", "to": "2026-08-27", "position": 2, "fixtureIds": [201101] },
    { "week": 2, "from": "2026-08-28", "to": "2026-09-03", "position": 1, "fixtureIds": [201188] }, … ],
  "meta": { "league": 195828, "season": 200386, "count": 9 } }