Skip to main content
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

​
league
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.
​
limit
integer
Number of teams to return per page. Default 100, maximum 200. Values above 200 are clamped to 200.
​
offset
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:
FieldTypeDescription
namestringTeam name
silk_urlstringPublic CDN URL of the team silk (kit thumbnail). Empty string ("") if the silk has not been resolved yet.
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.

​
Example Request

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

​
Example Response

{
  "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 for a full description of the envelope fields and how to page through results.