Skip to content
MyScore API

Get team match by ID

GET
/api/v1/team-matches/{id}
 
curl --request GET \
  --url https://internal.myscore.live/api/v1/api/v1/team-matches/tmm_abc123

Public endpoint. Returns a team match with aggregates (matches/sets/games won), lineup/doubles/approval timestamps, all entries and court assignment.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string
Example 
tmm_abc123

Team match ID

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Team match details

Media type application/json
object
id
required

Team match ID

string
leagueGroupId
required

League group this match belongs to

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
location

Free-text venue/location label

string
nullable
singlesCount
required

Number of singles matches in this team match (snapshotted from league at creation)

number
doublesCount
required

Number of doubles matches in this team match (snapshotted from league at creation)

number
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
homeSetsWon
required

Total sets won by the home side across all entries

number
guestSetsWon
required

Total sets won by the guest side across all entries

number
homeGamesWon
required

Total games won by the home side across all entries

number
guestGamesWon
required

Total games won by the guest side across all entries

number
homeSinglesWon
required

Singles matches won by the home side

number
guestSinglesWon
required

Singles matches won by the guest side

number
homeDoublesWon
required

Doubles matches won by the home side

number
guestDoublesWon
required

Doubles matches won by the guest side

number
homeLineupSubmittedAt

When the home captain submitted the singles lineup

string format: date-time
nullable
guestLineupSubmittedAt

When the guest captain submitted the singles lineup

string format: date-time
nullable
homeDoublesSubmittedAt

When the home captain submitted the doubles pairings

string format: date-time
nullable
guestDoublesSubmittedAt

When the guest captain submitted the doubles pairings

string format: date-time
nullable
homeApprovedAt

When the home side approved the final result

string format: date-time
nullable
guestApprovedAt

When the guest side approved the final result

string format: date-time
nullable
refereePlayerId

Player ID acting as referee, if any

string
nullable
refereeType

Refereeing arrangement type

string
nullable
Allowed values: home_captain guest_captain neutral
notes

Shared notes visible to both sides

string
nullable
homeNotes

Notes attached by the home side

string
nullable
guestNotes

Notes attached by the guest side

string
nullable
createdAt
required

Record creation timestamp

string format: date-time
updatedAt
required

Record last update timestamp

string format: date-time
homeTeam
required

Home team with club logo

object
id
required

Team ID

string
name
required

Team display name

string
guestTeam
required

Guest team with club logo

object
id
required

Team ID

string
name
required

Team display name

string
entries
required

All singles and doubles entries for this team match

Array<object>
object
id
required

Entry ID

string
teamMatchId
required

Parent team match ID

string
matchId

Underlying match ID once score entry begins (null until lineup is finalized)

string
nullable
matchType
required

Match type within the team match (singles or doubles)

string
position
required

Position within match type (1-based)

number
courtId

Assigned court ID, if any

string
nullable
match

Underlying match record once score entry begins

object
id
required

Match ID

string
status
required

Match lifecycle status

string
Allowed values: scheduled in_progress suspended completed cancelled
sets

Set scores in chronological order

Array<object>
nullable
object
home
required

Games won by the home side in this set

number
guest
required

Games won by the guest side in this set

number
notes

Match notes (delays, incidents, etc.)

string
nullable
winnerSide

Winning side

string
nullable
Allowed values: home guest
outcome

Match outcome type

string
nullable
Allowed values: completed walkover retirement default
confirmedAt

When the match result was confirmed

string format: date-time
nullable
confirmedByUserId

User who confirmed the match

string
nullable
startedAt

When the match started

string format: date-time
nullable
completedAt

When the match was completed

string format: date-time
nullable
finishedAt

When the match finished (alias of completedAt)

string format: date-time
nullable
createdAt
required

Record creation timestamp

string format: date-time
updatedAt
required

Record last update timestamp

string format: date-time
suggestedWinner

Server-computed winner suggestion from current sets + draw format rules. Null when score does not yet determine a winner. Read-only — distinct from confirmed winnerSide.

string
nullable
Allowed values: home guest
players
required

Players assigned to this entry from both sides

Array<object>
object
side
required

Side this player represents (home or guest)

string
position
required

Position within the side’s lineup (1-based)

number
playerId
required

Player ID

string
playerName
required

Player display name (snapshotted)

string
courtName

Court name (only when a single court hosts all entries)

string
nullable
Example 
{
  "id": "tmm_abc123",
  "leagueGroupId": "lgr_abc123",
  "homeTeamId": "tem_home123",
  "guestTeamId": "tem_guest123",
  "matchDay": 3,
  "scheduledAt": "2026-04-15T14:00:00.000Z",
  "location": "TC Wimbledon, Centre Court complex",
  "singlesCount": 6,
  "doublesCount": 3,
  "status": "upcoming",
  "homeMatchesWon": 5,
  "guestMatchesWon": 4,
  "homeSetsWon": 12,
  "guestSetsWon": 10,
  "homeGamesWon": 78,
  "guestGamesWon": 64,
  "homeSinglesWon": 4,
  "guestSinglesWon": 2,
  "homeDoublesWon": 1,
  "guestDoublesWon": 2,
  "homeLineupSubmittedAt": "2026-04-15T13:30:00.000Z",
  "guestLineupSubmittedAt": "2026-04-15T13:35:00.000Z",
  "homeDoublesSubmittedAt": "2026-04-15T16:00:00.000Z",
  "guestDoublesSubmittedAt": "2026-04-15T16:05:00.000Z",
  "homeApprovedAt": "2026-04-15T18:00:00.000Z",
  "guestApprovedAt": "2026-04-15T18:05:00.000Z",
  "refereePlayerId": "plr_referee123",
  "refereeType": "home_captain",
  "notes": "Match started 30 min late due to rain",
  "homeNotes": "Approved subject to player check",
  "guestNotes": "Disputed singles 3 — see lineup change",
  "createdAt": "2026-03-01T10:00:00.000Z",
  "updatedAt": "2026-04-15T18:05:00.000Z",
  "homeTeam": {
    "id": "tem_abc123",
    "name": "TC Musterstadt 1"
  },
  "guestTeam": {
    "id": "tem_abc123",
    "name": "TC Musterstadt 1"
  },
  "entries": [
    {
      "id": "tme_abc123",
      "teamMatchId": "tmm_abc123",
      "matchId": "mtch_abc123",
      "matchType": "singles",
      "position": 1,
      "courtId": "crt_abc123",
      "match": {
        "id": "match_abc123",
        "status": "scheduled",
        "sets": [
          {
            "home": 6,
            "guest": 4
          }
        ],
        "notes": "Rain delay at 3-2",
        "winnerSide": "home",
        "outcome": "completed",
        "confirmedAt": "2026-01-15T15:30:00.000Z",
        "confirmedByUserId": "usr_abc123",
        "startedAt": "2026-01-15T14:00:00.000Z",
        "completedAt": "2026-01-15T15:25:00.000Z",
        "finishedAt": "2026-01-15T15:25:00.000Z",
        "createdAt": "2026-01-15T10:30:00Z",
        "updatedAt": "2026-01-15T11:00:00Z",
        "suggestedWinner": "home"
      },
      "players": [
        {
          "side": "home",
          "position": 1,
          "playerId": "plr_federer",
          "playerName": "Roger Federer"
        }
      ]
    }
  ],
  "courtName": "Centre Court"
}

404

Section titled “404 ”

Team match not found