Teams

Introduction

If you need details about a team than this is the API to use. In it's pure form it will get you information about when the team started, what the address of their stadium is etc. When using the proper includes you can also get the status of the current season, the venue they play in, their current squad & coach etc.

{tip} Please note that the squad include only return the squad for the teams of the active season in the domestic main league the team is playing in. For international teams it will return the teams as is.

Please note that the following includes only returns the last or upcoming 25 items. visitorFixtures, localFixtures, visitorResults, localResults, latest, upcoming

The latest, upcoming and fixtures include may cause the response to be very big and finally fail because of memory limitations. To prevent this from happening we would suggest you to use filters to only return the data you actually need. an example could be: &include=localTeam.upcoming:limit(5|1):order(starting_at|asc)

Team By Id

Endpoint Options

Option Description
Endpoint https://soccer.sportmonks.com/api/v2.0/teams/{id}
Headers Accept: application/json
Paginated No, This endpoint is not paginated.
Includes country, squad*, coach, transfers, sidelined, stats, venue, fifaranking, uefaranking, visitorFixtures, localFixtures, visitorResults, localResults, latest, upcoming
Include Limit 3, The maximum level of includes that are allowed
Data Features All data features
Available via include Yes

Please note that the fifarankings include is currently only available for national teams.

Teams By Season

Endpoint Options

Option Description
Endpoint https://soccer.sportmonks.com/api/v2.0/teams/season/{id}
Headers Accept: application/json
Paginated No, This endpoint is not paginated.
Includes country, squad*, coach, transfers, sidelined, stats, venue, fifaranking, uefaranking, visitorFixtures, localFixtures, visitorResults, localResults, latest, upcoming
Include Limit 3, The maximum level of includes that are allowed
Data Features All data features
Available via include Yes

Please note that the fifarankings include is currently only available for national teams.