> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportrix.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /teams — List Teams in a League with Silk URLs

> GET /teams returns a paginated list of teams in a league, each with its silk (kit thumbnail) URL. Requires the fixtures scope and a league query parameter.

The teams endpoint lets you list the teams in a specific league along with each team's **silk** — a thumbnail of the team's kit — which you can render directly in your UI alongside team names. Use it when you need to populate league rosters, build filter dropdowns, or display team kits next to fixtures.

## Endpoint

```
GET https://api.sportrixdata.com/api/teams
```

## Authentication and Scope

This endpoint requires the `fixtures` scope. Include your API key in the `X-API-Key` header.

## Query Parameters

<ParamField query="league" type="integer" required>
  The league id to list teams for. Obtain this value from [`GET /leagues`](/api/leagues). The league must belong to a sport in your account's enabled allowlist; otherwise the response is empty.
</ParamField>

<ParamField query="limit" type="integer">
  Number of teams to return per page. Default `100`, maximum `200`. Values above 200 are clamped to 200.
</ParamField>

<ParamField query="offset" type="integer">
  Number of teams to skip before returning results. Default `0`. Use with `limit` to page through results.
</ParamField>

## Response

Returns a [pagination envelope](/concepts/pagination). Each item in `items` is a team object with the following fields:

| Field      | Type   | Description                                                                                                 |
| ---------- | ------ | ----------------------------------------------------------------------------------------------------------- |
| `name`     | string | Team name                                                                                                   |
| `silk_url` | string | Public CDN URL of the team silk (kit thumbnail). Empty string (`""`) if the silk has not been resolved yet. |

<Note>
  `silk_url` may be an empty string for newly discovered teams while the silk resolution pipeline is still running. Treat an empty value as "not yet available" and fall back to a placeholder in your UI — the field will populate on a later request once the silk is resolved.
</Note>

## Example Request

```bash theme={null}
curl "https://api.sportrixdata.com/api/teams?league=172" \
  -H "X-API-Key: $KEY"
```

## Example Response

```json theme={null}
{
  "items": [
    {
      "name": "Glamorgan",
      "silk_url": "https://cdn.sportrixdata.com/team_tshirts/cricket/img/GlamorganT20_2025.svg"
    }
  ],
  "total": 1,
  "limit": 100,
  "offset": 0,
  "count": 1,
  "page": 1,
  "total_pages": 1,
  "has_more": false
}
```

See the [Pagination guide](/concepts/pagination) for a full description of the envelope fields and how to page through results.