Skip to content

Get teams

GET
/v1/teams

Get teams

Authorizations

api_key
TypeAPI Key (header: X-Api-Key)

Parameters

Query Parameters

sorting
Typestring
Defaultnull
page_size

Number of items per page

Typeinteger
Default50
page

Current page

Typeinteger
Default1
team_slug

slug of the team according to https://liaison.reuters.com/tools/sports-team-codes

Typestring
Example"liverpool-fc"
team_name

name of the club

Typestring
Example"Liverpool FC"
popular

show popular clubs (most bookings)

Typeboolean
Exampletrue
club_logo

show teams with club logo

Typeboolean
Exampletrue
sport_type

Enum: soccer, motorsport, tennis, rugby, darts, horseracing, boxing, other, motogp, formula1, cricket, basketball, combatsport, icehockey, nba, nfl, mlb, watersport, dtm, indycar, superbike, padel

Typestring
Example"soccer"
tournament_id

tournament to filter results

Typestring
Example"6652b082b6d64e92af2794fb1e352e86_trn"
slug

seo friendly alternative to uuid

Typestring
Example"liverpool-fc"
iso_country

filter teams on their (ISO 3166-1 alpha-3) country of origin

Typestring
Example"GBR"
event_startdate

Only returns teams which are linked to events with a startdate matching this criteria

Typestring
Example"2024-04-01"
interesting

filter interesting teams

Typeboolean
Exampletrue
team_id

filter on Team ID

Typestring
Example"7841dbb553b74476b9236a92f56f27e9_tms"

Responses

OK

application/json
JSON
{
"teams": [
{
"official_name": "Liverpool FC",
"team_id": "7841dbb553b74476b9236a92f56f27e9_tms",
"popular_team": true,
"sport_type": "soccer",
"slug": "liverpool-fc",
"iso_country": "GBR",
"wikipedia_slug": "Liverpool FC",
"wikipedia_snippet": "Liverpool Football Club is a professional football club based in Liverpool, England. The club competes in the Premier League...",
"venue_id": "7d881550d5ba4cb2b3faca11a9b1695d_vnx",
"team_slug": "LIV",
"logo_filename": "liverpoolfc_lrkvr.png"
}
],
"pagination": {
"total_size": 1,
"page_size": 50,
"next_page": "string",
"previous_page": "string"
}
}

Playground

Server
Authorization
Variables
Key
Value

Samples