---
title: "List Teams by League ID"
method: GET
path: "/list/teams/{idLeague}"
tags: ["V2 API List"]
---

# List Teams by League ID

`GET /list/teams/{idLeague}`

## Request

- Base URL: `https://www.thesportsdb.com/api/v2/json`
- URL: `https://www.thesportsdb.com/api/v2/json/list/teams/{idLeague}`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/thesportsdb/apis/thesportsdb-v2-api/docs/list/teams/:idLeague/get.ts> (a function with typed inputs; its response is checked against the schema)

List all teams in a paritcular league by its unique ID.

## Path parameters

- `idLeague` integer, required

## Response `200`

List of teams in the specified league

- TeamList
  - `list` Team[]
    - `idTeam` string
    - `strTeam` string
    - `idLeague` string
    - `strLeague` string
    - `strBadge` string, uri
    - `strCountry` string
    - `strGender` 'Male' | 'Female' | 'Mixed'
    - `strLocation` string
    - `strSport` string

---

[API](https://skmtc.dev/thesportsdb/apis/thesportsdb-v2-api.md) - [All operations](https://skmtc.dev/thesportsdb/apis/thesportsdb-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/thesportsdb/apis/thesportsdb-v2-api/revisions/f529422e54bf?raw)