Teams
List teams
Returns teams, 20 per page. Use it to find a team_id by name, or to list every team in a competition season. With search, the best match comes first. Men’s and women’s sides of a club can share a name, so add is_mens_team to tell them apart.
Examples
- Arsenal men’s team:
GET /football/teams?search=Arsenal&is_mens_team=true - Premier League 2026/27 teams:
GET /football/teams?competition_id=comp_3039&season_id=sn_8406098
GET
/
football
/
teams
List teams
curl --request GET \
--url https://api.thestatsapi.com/api/football/teams \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.thestatsapi.com/api/football/teams', 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"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "tm_0406",
"name": "Liverpool",
"short_name": "Liverpool",
"country": "England",
"is_mens_team": true,
"primary_competition": {
"id": "comp_3039",
"name": "Premier League"
}
}
],
"meta": {
"page": 1,
"per_page": 20,
"total": 100,
"total_pages": 5
}
}Use it to find a
team_id. More ways to look up IDs: Finding IDs.Authorizations
Your API key, sent as Authorization: Bearer YOUR_API_KEY. Get one at https://www.thestatsapi.com/api-keys
Query Parameters
⌘I
List teams
curl --request GET \
--url https://api.thestatsapi.com/api/football/teams \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.thestatsapi.com/api/football/teams', 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"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "tm_0406",
"name": "Liverpool",
"short_name": "Liverpool",
"country": "England",
"is_mens_team": true,
"primary_competition": {
"id": "comp_3039",
"name": "Premier League"
}
}
],
"meta": {
"page": 1,
"per_page": 20,
"total": 100,
"total_pages": 5
}
}