Skip to content
MyScore API

List team matches

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

Public endpoint. Lists team matches across league groups, with filters by team, club, status, league category, and date range.

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
leagueGroupId
string

Filter by league group

teamId
string

Filter by team (home or guest side)

clubId
string

Filter by club ID (home or guest team’s club)

status
string

Filter by status (scheduled, in_progress, completed, cancelled)

dateFrom
string

Filter from date (ISO 8601, inclusive)

dateTo
string

Filter to date (ISO 8601, inclusive)

category
string

Filter by league category (youth, active, senior)

Responses

Section titled “ Responses ”

200

Section titled “200 ”

List of team matches

Media type application/json
Array<object>
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 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": "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"
    }
  }
]

429

Section titled “429 ”

Rate limit exceeded