> ## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.