Match Endpoints - SportsAPI Pro

Scoring Format

Table tennis is best of 5 or 7 games. Use GET /api/match/:matchId — it returns:

{
  "id": 16939855,
  "status": { "code": 12, "description": "5th set", "type": "inprogress" },
  "homeScore": { "current": 2, "period1": 8, "period2": 11, "period3": 11, "period4": 3, "period5": 0 },
  "awayScore": { "current": 2, "period1": 11, "period2": 9, "period3": 9, "period4": 11, "period5": 3 },
  "lastPeriod": "period5",
  "defaultPeriodCount": 5,
  "startTimestamp": 1787912400
}

period1–period7 = points per game (games to 11, win by 2)
current = games won
lastPeriod plus status.description = the active game; its period{N} pair is the live point score

Timing: there is no clock or duration field for table tennis. startTimestamp is the scheduled start and can differ from the actual start by minutes in either direction; time.currentPeriodStartTimestamp (present on some matches only) marks the start of the current game. For an accurate elapsed-time counter, record the moment a match first transitions to status.type: "inprogress" on your side and count from there.

Match Details

GET /api/match/:matchId

Game Scores

GET /api/match/:matchId/scores

Not available for table tennis — this sub-resource returns an upstream 404. Read the per-game scores from GET /api/match/:matchId instead. The same applies to /graph.

Point by Point

GET /api/match/:matchId/point-by-point

Point-by-point live data for real-time tracking. Each set object contains a points array (homePoint, awayPoint, homePointType, awayPointType) and a score object.

Current server is not available for table tennis. The score.serving field exists in the schema but is returned as -1 (unknown) for table tennis matches, and table tennis events carry no firstToServe field (unlike Tennis V2). Aggregate service data is available after the fact via /statistics (“Service points won”, “Receiver points won”).

Lineups

GET /api/match/:matchId/lineups

Statistics

GET /api/match/:matchId/statistics

Incidents

GET /api/match/:matchId/incidents

Game results, timeouts.

Player Statistics

GET /api/match/:matchId/player-statistics

Individual Player Stats

GET /api/match/:matchId/player/:pid/statistics

Best Players

GET /api/match/:matchId/best-players

MVP Award

GET /api/match/:matchId/award

Head to Head

GET /api/match/:matchId/h2h

Scoring Graph

GET /api/match/:matchId/graph

Pre-Game Form

GET /api/match/:matchId/pregame-form

Streaks

GET /api/match/:matchId/streaks

Highlights

GET /api/match/:matchId/highlights

Media

GET /api/match/:matchId/media

Fan Predictions

GET /api/match/:matchId/votes

Venue

GET /api/match/:matchId/venue

Referee / Umpire

GET /api/match/:matchId/referee

TV Channels

GET /api/match/:matchId/channels

Featured Odds

GET /api/match/:matchId/odds

All Odds

GET /api/match/:matchId/odds/all

Pre-Match Odds

GET /api/match/:matchId/odds/pre-match

Live Odds

GET /api/match/:matchId/odds/live

Win Probability

GET /api/match/:matchId/winning-odds

​Scoring Format

​Match Details

​Game Scores

​Point by Point

​Lineups

​Statistics

​Incidents

​Player Statistics

​Individual Player Stats

​Best Players

​MVP Award

​Head to Head

​Scoring Graph

​Pre-Game Form

​Streaks

​Highlights

​Media

​Fan Predictions

​Venue

​Referee / Umpire

​TV Channels

​Featured Odds

​All Odds

​Pre-Match Odds

​Live Odds

​Win Probability

Scoring Format

Match Details

Game Scores

Point by Point

Lineups

Statistics

Incidents

Player Statistics

Individual Player Stats

Best Players

MVP Award

Head to Head

Scoring Graph

Pre-Game Form

Streaks

Highlights

Media

Fan Predictions

Venue

Referee / Umpire

TV Channels

Featured Odds

All Odds

Pre-Match Odds

Live Odds

Win Probability