Teams
Contents

What Sportmonks provides

Each team record in the Football API v3 includes:
– Team ID, name, and short code
– Country ID and sport ID
– Home venue ID
– Team type (domestic or national)
– Gender
– Founded year
– Team logo via image_path
– last_played_at timestamp
– placeholder flag indicating whether the team is a
– TBD slot in a competition draw

Beyond the base record, teams support a wide set of includes that let you retrieve everything from current squad members and injury absences through to season statistics, trophies, and social media accounts.

Endpoints

There are five team endpoints:

GET All Teams returns every team available within your subscription.

GET https://api.sportmonks.com/v3/football/teams?api_token=YOUR_TOKEN

GET Team by ID returns a single team by its ID. This is the most common entry point when you already have a team ID from a fixture or standings response and want the full team profile.

GET https://api.sportmonks.com/v3/football/teams/{team_id}?api_token=YOUR_TOKEN

GET Teams by Country ID returns all teams from a given country. Useful for building country-level team directories.

GET https://api.sportmonks.com/v3/football/teams/countries/{country_id}?api_token=YOUR_TOKEN

GET Teams by Season ID returns all teams participating in a given season. Use this to pre-fetch the full set of club records for a league at the start of a season.

GET https://api.sportmonks.com/v3/football/teams/seasons/{season_id}?api_token=YOUR_TOKEN

GET Teams by Search by Name returns teams matching a name search query. Useful for powering autocomplete or search features in your application.

GET https://api.sportmonks.com/v3/football/teams/search/{name}?api_token=YOUR_TOKEN

Includes

Team records support a comprehensive set of includes. The most commonly used are:
– country — adds country metadata for the team
– venue — adds the team’s home stadium record
– players — returns the current registered players at the club
– coaches — returns the current coaching staff
– rivals — returns the team’s registered rivals
– seasons — returns all seasons the team has participated in
– activeSeasons — returns only the team’s currently active seasons
– latest — returns the team’s most recently played fixtures
– upcoming — returns the team’s next scheduled fixtures
– sidelined — returns players currently unavailable due to injury or suspension
– sidelinedHistory — returns the full historical sidelined record for the team
– statistics — returns aggregated team statistics, filterable by season using currentSeasons
– trophies — returns all trophies won by the team
– socials — returns the team’s social media account links
– rankings — returns any ranking data associated with the team
– Example request retrieving a team with its venue, active seasons, and trophies:

GET https://api.sportmonks.com/v3/football/teams/{team_id}?api_token=YOUR_TOKEN&include=venue;activeSeasons;trophies

What you can build with team data

Club profile pages covering team identity, home ground, founding year, and logo for clubs across the Premier League, La Liga, Bundesliga, Serie A, Champions League, and beyond

Squad and staff pages using the players and coaches includes to list of current registered players and coaching staff.

Form and fixture widgets using the latest and upcoming includes to surface a team’s recent results and next matches without additional requests.

Injury and availability trackers using the sidelined include to display which players are currently unavailable and what games they have missed.

Season statistics dashboards combine the statistics include with the currentSeasons filter to show a team’s current campaign performance.

Trophy cabinets using the trophies include a list of all honours won by a club across their history.

Team search and autocomplete using the search endpoint to let users find teams by name within your application.

Availability

Team data is included in all Starter, Growth, Pro, and Enterprise plans. The teams available to you correspond to the leagues within your subscription. You can explore and test the team endpoints using the Sportmonks Postman collection or the API tester in MySportmonks.

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 teams

How do I retrieve all teams in a specific league season?
Use GET Teams by Season ID with the relevant season ID. This returns every team participating in that season and is the recommended approach for pre-fetching club data at the start of a campaign.
How do I get a team's current squad?
Add the players include to a GET Team by ID request to return the current registered players at the club. For more detailed squad information, including jersey numbers and contract dates, use the team squads endpoints instead.
How do I get a team's current and upcoming fixtures?
Use the latest and upcoming includes on any team endpoint request. These return the team's most recently played and next scheduled fixtures, respectively, without needing a separate call to the fixtures endpoints.
Can I retrieve a team's season statistics?
Yes. Add the statistics include to a team request. Use the currentSeasons filter alongside it to restrict results to the active season only, rather than returning all historical statistics.
Is team data available on all plans?
Yes. Team data is included in all Starter, Growth, Pro, and Enterprise plans.

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