> ## Documentation Index
> Fetch the complete documentation index at: https://polymarket-data.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Teams

> Retrieve team rosters, leagues, and branding assets via gamma.sports.listTeams.

`client.gamma.sports.listTeams` exposes the teams tracked by Polymarket across supported leagues.
Use it to populate dropdowns, leaderboards, or sports dashboards.

## Request

```ts theme={null}
const teams = await client.gamma.sports.listTeams(params);
```

### Parameters

| Name           | Type           | Required | Default | Notes                                         |
| -------------- | -------------- | -------- | ------- | --------------------------------------------- |
| `limit`        | `number` (≥ 0) |          | –       | Number of results.                            |
| `offset`       | `number` (≥ 0) |          | –       | Pagination offset.                            |
| `order`        | `string`       |          | –       | Comma-separated fields to sort by.            |
| `ascending`    | `boolean`      |          | –       | Sort direction.                               |
| `league`       | `string[]`     |          | –       | Filter by league identifiers (e.g., `"NBA"`). |
| `name`         | `string[]`     |          | –       | Filter by team names.                         |
| `abbreviation` | `string[]`     |          | –       | Filter by abbreviations.                      |

## Response

```ts theme={null}
type Team = {
  id: number;
  name: string | null;
  league: string | null;
  record: string | null;
  logo: string | null;
  abbreviation: string | null;
  alias: string | null;
  createdAt: string | null;
  updatedAt: string | null;
  providerId: number | null;
};
```

## Usage example

```ts theme={null}
const nbaTeams = await client.gamma.sports.listTeams({ league: ["NBA"], limit: 50 });

nbaTeams.forEach((team) => console.log(team.name));
```

## Failure modes

* Numeric parameters must be non-negative.
* Empty arrays (e.g., `league: []`) trigger validation errors.