Skip to content
datasportsAPI

TeamsTrophies

Documentation

/

Type to filter the docs by title or path.

TeamsEndpoint 45 of 116

Trophies

GET

/v2/teams/{id}/trophies

Plan
All plans
Auth
Bearer dsa_live_…
Parameters
1 required · 0 optional
Returns
Trophy[]
Try in Playground

Everything the team has won: each competition with its type (domestic league, domestic cup, international cup, other), a flag for major titles, the number of wins and the winning seasons, most recent first.

Worth knowing

A team that has never won a trophy gets 200 and an empty array.

01Parameters

  • idpathRequired

    DataSportsAPI team id, a positive integer

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/teams/{id}/trophies"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
Trophy[]
meta
count (number of competitions), totalCount (overall trophy tally as the source counts it, or null if the source gives none)
ObjectsTrophy
Example response
{ "data": [ { "league": { "id": 195830, "name": "LaLiga", "slug": "laliga", "sport": "football", … },
    "competitionType": "domesticLeague", "major": true, "count": 36,
    "seasons": [ { "year": "23/24", "startYear": 2023, "endYear": 2024 }, { "year": "21/22", "startYear": 2021, "endYear": 2022 }, … ] },
  { "league": { "name": "UEFA Champions League", … }, "competitionType": "internationalCup", "major": true, "count": 15, … }, … ],
  "meta": { "count": 15, "totalCount": 101 } }

04Errors

Nothing specific to this endpoint: only the account-wide errors below apply.

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code