Teams - AnySport

Returns basic team profiles (team name, country, home venue), supporting three query modes: look up a single team’s details by team_id, fuzzy search by name, or query the roster of teams competing in a given edition/season using league_id+season. The latter is useful for pages like “competition participant list” — the teams participating in the same league can differ across seasons (e.g. the World Cup expanded from 43 to 48 teams), so when querying by league you must include season to specify the exact edition. The basic team information itself is a current snapshot and does not change by season.

Endpoint

GET /v1/soccer/teams

Parameters

Parameter	Type	Required	Description
`team_id`	string	No	Query by team ID (`ast_`)
`league_id`	string	No	Query participating teams by league (`asl_`)
`season`	string	Conditionally required	Required when querying by `league_id` (since a league spans multiple editions/seasons, `season` is needed to pin down the exact participant list; e.g. World Cup `2026` → 48 teams, `2022` → 43 teams). Not applicable when querying by team_id/team_name
`team_name`	string	No	Fuzzy search by name
`lang`	string	No	`en` / `zh-CN`; invalid values silently fall back to the default language — see `GET /languages` (19) for available values
`page` / `limit`	int	No	Pagination, limit range 1–100

Filter conditions can be combined. Querying by league_id without season returns 400 (INVALID_PARAMS). A team’s basic information (name/venue, etc.) is a current snapshot; the league_id+season combination returns the participant list for that specific edition/season.

Response fields (data: array)

Field	Type	Description
`team_id`	string	Team ID (`ast_` prefix)
`name`	string	Team name
`country`	string	Country/region the team belongs to
`venue`	string	Home venue

Request example

# Teams participating in the current edition (2026)
GET /v1/soccer/teams?league_id=asl_62db9cfc3ebf4b87a44570b16668b23e&season=2026&lang=en&limit=5

# Teams participating in a historical edition (2022)
GET /v1/soccer/teams?league_id=asl_62db9cfc3ebf4b87a44570b16668b23e&season=2022&lang=en&limit=5

Response example

season=2026 (HTTP 200, total=48)

{
  "success": true,
  "data": [
    {
      "team_id": "ast_f6090c8ded1f42e58226eedf59813890",
      "name": "Algeria",
      "country": "intl",
      "venue": "Stade Mohamed-Hamlaoui"
    },
    {
      "team_id": "ast_9137ee449e3b40a68149ca319373adaf",
      "name": "Argentina",
      "country": "intl",
      "venue": "Estadio Alberto José Armando"
    }
  ],
  "meta": {
    "total": 48,
    "page": 1,
    "limit": 5,
    "total_pages": 10,
    "timestamp": "2026-07-13T19:18:23.092928200Z"
  },
  "traceId": "7890e4ed-e2f7-435f-bb75-9dc795351100"
}

season=2022 (historical editions are queryable and not mixed across editions)

{
  "success": true,
  "data": [
    {
      "team_id": "ast_f6090c8ded1f42e58226eedf59813890",
      "name": "Algeria",
      "country": "intl",
      "venue": "Stade Mohamed-Hamlaoui"
    }
  ],
  "meta": {
    "total": 43,
    "page": 1,
    "limit": 5,
    "total_pages": 9,
    "timestamp": "2026-07-13T19:18:23.269297700Z"
  },
  "traceId": "8601ff66-85be-4680-838b-35e2fa8ed81c"
}

Error example

Querying by league_id without season → HTTP 400, error.code = INVALID_PARAMS.

GET /v1/soccer/teams?league_id=asl_62db9cfc3ebf4b87a44570b16668b23e&limit=5

​Endpoint

​Parameters

​Response fields (data: array)

​Request example

​Response example

​Error example

Endpoint

Parameters

Response fields (data: array)

Request example

Response example

Error example