Teams
Get a team's season stats
Returns a team’s record for one season: matches played, wins, draws, losses, goals, points, table position and recent form. season_id is required. Returns 404 when the team has no stats for that season.
Example: GET /football/teams/tm_9145/stats?season_id=sn_6125938 (Arsenal, Premier League 2025/26)
GET
/
football
/
teams
/
{team_id}
/
stats
Get a team's season stats
curl --request GET \
--url https://api.thestatsapi.com/api/football/teams/{team_id}/stats \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.thestatsapi.com/api/football/teams/{team_id}/stats', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.thestatsapi.com/api/football/teams/{team_id}/stats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"team_id": "tm_9145",
"season_id": "sn_6125938",
"competition_id": "comp_3039",
"matches_played": 38,
"wins": 26,
"draws": 7,
"losses": 5,
"points": 85,
"position": 1,
"goals_for": 71,
"goals_against": 27,
"goal_difference": 44,
"form": "WWWWW",
"expected_goals_for": 18.42,
"expected_goals_against": 11.07,
"xg_matches": 9
}
}Walkthrough with code: Player and team stats.
Authorizations
Your API key, sent as Authorization: Bearer YOUR_API_KEY. Get one at https://www.thestatsapi.com/api-keys
Path Parameters
Query Parameters
⌘I
Get a team's season stats
curl --request GET \
--url https://api.thestatsapi.com/api/football/teams/{team_id}/stats \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.thestatsapi.com/api/football/teams/{team_id}/stats', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.thestatsapi.com/api/football/teams/{team_id}/stats"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"team_id": "tm_9145",
"season_id": "sn_6125938",
"competition_id": "comp_3039",
"matches_played": 38,
"wins": 26,
"draws": 7,
"losses": 5,
"points": 85,
"position": 1,
"goals_for": 71,
"goals_against": 27,
"goal_difference": 44,
"form": "WWWWW",
"expected_goals_for": 18.42,
"expected_goals_against": 11.07,
"xg_matches": 9
}
}