SPsportmonks
Team Rankings

Team Rankings by Team ID

Returns the ranking history of the requested team, ordered by 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/teams/{teamId}

Request

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

Path parameters

teamIdinteger required

The ID of the team you want to retrieve rankings for.

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.