Skip to content
Get a key
API reference / Standings
GET/hockey/leagues/{id}/standings

Get league standings

Returns a league's table as the data provider sends it for that sport: soccer with position, form and overall/home/away records; NBA, NHL, MLB, NFL and NCAA by conference and division; other leagues as one table; cricket: computed from the results (IPL, BBL, The Hundred, PSL, CPL, SA20, T20 Blast, County Championship, Sheffield Shield, Ranji Trophy...), with the points rules in rules and groups per group or division. Where the data provider has no usable table, the current table of the Wikipedia season article is served as it stands (rugby union: Premiership, Top 14, URC, Super Rugby, Six Nations; cricket with bonus points and deductions: County Championship, Sheffield Shield, World Test Championship), with source wikipedia, as_of (the time of the page revision) and the attribution in data and meta. Read again a few minutes after each of the league's matches finishes, and weekly. 404 for leagues without a table (cups, uncovered leagues).

In the plans that cover this sportPay per call without a key: $0.002 in USDC

Parameters

  • idinteger · pathrequired

    League ID

Response

JSON with success, the result in data, and where the endpoint pages its results meta.

  • dataobject
  • as_ofstring
  • attributionstring
  • checked_atstring
  • league_idinteger
  • seasonstring
  • sourcestring

    Tables from Wikipedia (rugby union, cricket bonus-point tables): source "wikipedia", as_of the page revision's time, attribution. Tables we compute from results where the feed has none: source "computed" (points deductions not included). Tables from the official league or federation page: source "official", source_url the page.

  • source_urlstring
  • sportstring
  • standingsobject
  • updated_atstring

    when the table last changed

  • errorobject
  • codestring
  • messagestring
  • metaobject
  • attributionstring

    Attribution a data source's licence asks for (Cricsheet's history).

  • limitinteger
  • offsetinteger
  • totalinteger
  • successboolean

Errors

StatusCodeWhen
400INVALID_PARAMA parameter is missing or wrong, and the message names it. Fix the request; do not retry it.
401UNAUTHORIZEDThe key is missing, mistyped or was rotated.
402x402 offersNo key and no valid payment: the body lists what to pay. Only a 200 answer is charged.
403FORBIDDENThe sport or feature is not in your plan (FEATURE_NOT_IN_PLAN for Insights and other plan features).
404NOT_FOUNDNo record with that id.

All errors have the shape described in Errors and limits.

Generated from the OpenAPI file, version 1.0. See it as JSON

Was this page helpful?