GET /teams — List Teams in a League with Ids and Silk Images

The teams endpoint lets you list the teams in a specific league along with each team’s opaque id and its 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.sportrix.ai/api/teams

Authentication and Scope

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

Query Parameters

integer

required

The league id to list teams for. Obtain this value from GET /leagues. The league must belong to a sport in your account’s enabled allowlist; otherwise the response is empty.

integer

Number of teams to return per page. Default 100, maximum 200. Values above 200 are clamped to 200.

integer

Number of teams to skip before returning results. Default 0. Use with limit to page through results.

Response

Returns a pagination envelope. Each item in items is a team object with the following fields:

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

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

Example Request

curl "https://api.sportrix.ai/api/teams?league=172" \
  -H "X-API-Key: $KEY"

Example Response

{
  "items": [
    {
      "id": "Xq2Vn7Kd",
      "name": "Glamorgan",
      "image": "https://cdn.sportrix.ai/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 for a full description of the envelope fields and how to page through results.

REST API

WebSocket

Data Schemas

GET /teams — List Teams in a League with Ids and Silk Images

Endpoint

Authentication and Scope

Query Parameters

Response

Example Request

Example Response

​Endpoint

​Authentication and Scope

​Query Parameters

​Response

​Example Request

​Example Response

Endpoint

Authentication and Scope

Query Parameters

Response

Example Request

Example Response