GoSportsAPIDocs
Sign InGet API Key
Football / Standings

Get Standings

Retrieve the league table for a season — position, points, goals and recent form for every team.

GET/v1/football/standings

Parameters

NameTypeRequiredDescription
x-api-keystringRequiredYour API key, sent as a header.
league_idintegerRequiredLeague ID.
seasonintegerRequiredSeason start year. Available from [YYYY].
team_idintegerOptionalReturn only this team’s row.

Response

  • dataarray<Standing>
    One row per team, ordered by rank.
  • rankinteger
    Current league position.
  • teamobject
    id and name.
  • playedinteger
    Matches played.
  • pointsinteger
    Total points.
  • goalsobject
    for, against and diff.
  • formstring
    Last five results, most recent last.
  • metaobject
    league_id and season.

Status codes

  • 200Standings returned
  • 400Invalid parameter
  • 401Missing or invalid API key
  • 429Rate limit reached