SPsportmonks
Team Rankings

Team Rankings by date

Returns all team rankings for the requested date.

Beta. This endpoint is published upstream under team-rankings-beta and may change without a major version. It also requires a separate Team Rankings add-on on your subscription; without it the API answers 403 with error code 5007.

Sportmonks documentation

get/football/team-rankings/date/{date}

Request

  • Base URL
    https://api.sportmonks.com/v3
  • Auth
    • API key in query parameter api_token
    • or API key in header Authorization

Path parameters

datestring date required

The date to retrieve rankings for, formatted YYYY-MM-DD. The docs page renders this placeholder as YYY_MM_DD, which is a documentation typo — the API validator requires Y-m-d.

Query parameters

includestring

Enrich the API response with more data by using includes. Ex. &include=team

Allowed values: team. Pass as a semicolon-separated list (the API rejects comma here), e.g. include=team.

selectstring[]

Select specific fields on the base entity . Read how to select fields in our tutorial .

Selectable fields: id, team_id, date, current_rank, scaled_score. Pass as a comma-separated list, e.g. select=team_id,current_rank.

localestring

Translate name fields of the API Response in your selected language. Find more information and which languages are available on our translations page .

per_pageinteger

The amount of results to return per page (max 50.). Defaults to 25.

pageinteger

You can paginate using the has_more parameter to determine if you can still propagate through the results.

Response

Success.

timezonestring required

Example response

{
  "data": [
    {
      "date": "2025-08-25"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.