American Football / Standings

Get Standings

Retrieve division and conference standings for a season — record, winning percentage and points for and against.

GET/v1/american-football/standings

Parameters

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

Response

  • dataarray<Standing>
    One row per team, ordered by rank.
  • rankinteger
    Position in the division or conference.
  • teamobject
    id and name.
  • recordobject
    wins, losses and ties.
  • win_pctnumber
    Winning percentage, 0–1.
  • pointsobject
    for, against and diff.
  • metaobject
    league_id, season and division.

Status codes

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