GET /football/teams — list and filter teams - The Stats API

List teams

Endpoint

GET https://api.thestatsapi.com/api/football/teams

Retrieve a paginated list of teams with optional filters

Query parameters

Name	Type	Required	Default	Description
`page`	integer	No	`1`	Page number (default 1)
`per_page`	integer	No	`20`	Results per page (default 20, max 100). The legacy alias `limit` is also accepted and behaves identically.
`competition_id`	string	No		Filter teams by competition (optional). Example: `comp_3039`
`season_id`	string	No		Filter teams by season (optional, requires competition_id). Example: `sn_6125938`
`country`	string	No		Filter teams by country (optional)
`search`	string	No		Search teams by name (case-insensitive partial match). Example: `Arsenal`

Response (200)

{
  "data": [
    {
      "id": "tm_0406",
      "name": "Liverpool",
      "short_name": "Man Utd",
      "country": "England",
      "primary_competition": {
        "id": "comp_3039",
        "name": "Premier League"
      }
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 100,
    "total_pages": 5
  }
}

This page is generated from the live API contract at https://api.thestatsapi.com/llms.txt.