Skip to content
MyScore API

Get team by ID

GET
/api/v1/teams/{id}
 
curl --request GET \
  --url https://internal.myscore.live/api/v1/api/v1/teams/tm_abc123

Public endpoint. Returns a team with its roster (players + captain/TP flags) and upcoming/past team matches.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string
Example 
tm_abc123

Team ID

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Team details with roster and matches

Media type application/json
object
id
required

Team ID

string
clubId
required

Owning club ID

string
leagueGroupId
required

League group this team competes in

string
name
required

Team display name

string
createdAt
required

Record creation timestamp

string format: date-time
updatedAt
required

Record last update timestamp

string format: date-time
roster
required

Full roster — every team player with their player profile

Array<object>
object
teamPlayer
required

Team membership record

object
id
required

Team player record ID

string
teamId
required

Parent team ID

string
playerId
required

Player ID

string
isCaptain
required

Whether this player is the team captain

boolean
hasManageRights
required

Whether this player has team-management rights (lineup submission, approval)

boolean
rankingPosition

Player’s ranking position within the team (1 = strongest)

number
nullable
isGuestPlayer
required

Whether this player is a guest (does not count against permanent roster)

boolean
createdAt
required

Record creation timestamp

string format: date-time
updatedAt
required

Record last update timestamp

string format: date-time
player
required

Player profile snapshot

object
id
required

Player ID

string
name
required

Player display name

string
gender

Player gender

string
nullable
upcomingMatches
required

Upcoming team matches involving this team

Array<object>
object
id
required

Team match ID

string
leagueGroupId
required

League group ID

string
homeTeamId
required

Home team ID

string
guestTeamId
required

Guest team ID

string
matchDay

Match day number within the season

number
nullable
scheduledAt

Scheduled kickoff time

string format: date-time
nullable
status
required

Status (upcoming, in_progress, completed, cancelled)

string
homeMatchesWon
required

Singles + doubles matches won by the home side

number
guestMatchesWon
required

Singles + doubles matches won by the guest side

number
homeTeam
required

Home team summary

object
id
required

Team ID

string
name
required

Team display name

string
guestTeam
required

Guest team summary

object
id
required

Team ID

string
name
required

Team display name

string
pastMatches
required

Completed team matches involving this team

Array<object>
object
id
required

Team match ID

string
leagueGroupId
required

League group ID

string
homeTeamId
required

Home team ID

string
guestTeamId
required

Guest team ID

string
matchDay

Match day number within the season

number
nullable
scheduledAt

Scheduled kickoff time

string format: date-time
nullable
status
required

Status (upcoming, in_progress, completed, cancelled)

string
homeMatchesWon
required

Singles + doubles matches won by the home side

number
guestMatchesWon
required

Singles + doubles matches won by the guest side

number
homeTeam
required

Home team summary

object
id
required

Team ID

string
name
required

Team display name

string
guestTeam
required

Guest team summary

object
id
required

Team ID

string
name
required

Team display name

string
Example 
{
  "id": "tem_abc123",
  "clubId": "clb_abc123",
  "leagueGroupId": "lgr_abc123",
  "name": "TC Musterstadt 1",
  "createdAt": "2026-03-01T12:00:00.000Z",
  "updatedAt": "2026-03-01T12:00:00.000Z",
  "roster": [
    {
      "teamPlayer": {
        "id": "tpl_abc123",
        "teamId": "tem_abc123",
        "playerId": "plr_federer",
        "isCaptain": false,
        "hasManageRights": false,
        "rankingPosition": 4,
        "isGuestPlayer": false,
        "createdAt": "2026-03-01T12:00:00.000Z",
        "updatedAt": "2026-03-01T12:00:00.000Z"
      },
      "player": {
        "id": "plr_federer",
        "name": "Roger Federer",
        "gender": "male"
      }
    }
  ],
  "upcomingMatches": [
    {
      "id": "tmm_abc123",
      "leagueGroupId": "lgr_abc123",
      "homeTeamId": "tem_home123",
      "guestTeamId": "tem_guest123",
      "matchDay": 3,
      "scheduledAt": "2026-04-15T14:00:00.000Z",
      "status": "upcoming",
      "homeMatchesWon": 5,
      "guestMatchesWon": 4,
      "homeTeam": {
        "id": "tem_abc123",
        "name": "TC Musterstadt 1"
      },
      "guestTeam": {
        "id": "tem_abc123",
        "name": "TC Musterstadt 1"
      }
    }
  ],
  "pastMatches": [
    {
      "id": "tmm_abc123",
      "leagueGroupId": "lgr_abc123",
      "homeTeamId": "tem_home123",
      "guestTeamId": "tem_guest123",
      "matchDay": 3,
      "scheduledAt": "2026-04-15T14:00:00.000Z",
      "status": "upcoming",
      "homeMatchesWon": 5,
      "guestMatchesWon": 4,
      "homeTeam": {
        "id": "tem_abc123",
        "name": "TC Musterstadt 1"
      },
      "guestTeam": {
        "id": "tem_abc123",
        "name": "TC Musterstadt 1"
      }
    }
  ]
}

404

Section titled “404 ”

Team not found