Squads
Contents

What Sportmonks provides

Each squad record includes the player ID, team ID, position ID, detailed position ID, and transfer ID. It also includes two status flags:

– is_captain — indicates whether the player is the current default captain for that squad
– in_squad — on the extended endpoint, marks false if a player is no longer active in the current squad or is a youth team player

Season-level player performance statistics are available via the PlayerStatistic entity, accessible through the player include on squad records.

Historical squads are available from 2005 onwards, though coverage varies by league. Historical data is being loaded continuously and is not yet complete for all competitions.

Endpoints

The Team Squads group has three endpoints.

GET Team Squad by Team ID — returns the current domestic squad for a given team:

GET https://api.sportmonks.com/v3/football/squads/teams/{team_id}

GET Extended Team Squad by Team ID — returns all squad entries for a team based on current seasons, including players no longer active or currently in the youth squad, identified by the in_squad flag:

GET https://api.sportmonks.com/v3/football/squads/teams/{team_id}/extended

GET Team Squad by Team and Season ID — returns the registered squad for a specific team in a specific historical season:

GET https://api.sportmonks.com/v3/football/squads/seasons/{season_id}/teams/{team_id}

All three endpoints support the team, player, position, detailedPosition, and transfer includes (include depth: 3).

What you can build with squad data

Current squad pages displaying every registered player at a club alongside their position and captain status, covering clubs across the Premier League, La Liga, Bundesliga, Serie A, Champions League, and beyond

Historical squad archives using the by-season endpoint to show which players were registered to a club in any given season from 2005 onwards

Squad depth charts using position and detailed position includes to group players by role and visualise a club’s options in each area of the pitch.

Seasonal player performance tables combining squad records with the PlayerStatistic entity to display each player’s in-season output alongside their squad entry

Transfer tracking features using the transfer include on squad records to surface recent arrival and departure data alongside current squad listings.

Extended squad views using the extended endpoint to show full registered lists, including fringe players and youth squad members, with clear active or inactive labelling via the in_squad flag

Availability

Squad data is included in all Starter, Growth, Pro, and Enterprise plans. Historical squad coverage from 2005 onwards varies by league. Check the Sportmonks coverage page to confirm which leagues support historical squads before building features that depend on them.

Try it free. All paid plans include a 14-day free trial, and the forever-free plan gives you immediate access to the Danish Superliga and Scottish Premiership with no credit card required.

FAQs about squads

What is the difference between the standard and extended squad endpoints?
The GET Team Squad by Team ID endpoint returns the current active domestic squad. The GET Extended Team Squad by Team ID endpoint returns all players associated with a team's current seasons, including those no longer in the first-team squad or currently playing in the youth setup, identified by the in_squad boolean field.
How do I retrieve a squad from a previous season?
Use the GET Team Squad by Team and Season ID endpoint, passing both the team ID and the season ID. Historical squad data is available from 2005, though coverage is not yet complete for all competitions.
How do I identify the squad captain?
Each squad record includes an is_captain boolean field. A value of true indicates the player is the current default captain for that squad.
Can I retrieve player statistics alongside squad data?
Yes. Use the player include on squad records to access the PlayerStatistic entity, which contains the player's in-season performance data for the requested season.

Written by David Jaja

David Jaja is a technical content manager at Sportmonks, where he makes complex football data easier to understand for developers and businesses. With a background in frontend development and technical writing, he helps bridge the gap between technology and sports data. Through clear, insightful content, he ensures Sportmonks' APIs are accessible and easy to use, empowering developers to build standout football applications