Match Score - Match Play
Applies when Tournament(s)/`format`="Match"This is a live websocket endpoint that returns hole by hole scores for a match. The whole json is sent whenever there is an update. You should receive a new update when a hole is completed.The authentication token provided will be required to make a connection to this websocket endpoint.This web socket is the match play equivalent to Team Hole by Hole Score web socket for stroke play.
Endpoint URL
wss://dde-streams.imggaming.com/media/golf/tournaments/{tournament ID}/matchscore/{matchNo}
Process for connecting the web socket endpoints
Same as Team Hole-by-Hole Score
Request parameters
Same as Team Hole-by-Hole Score
Match Score - match play via RestAPI
Note that the Match score websockets is available via Rest - https://dde-api.data.imgarena.com/media/golf/tournaments/{EventID}}/matchscore/{MatchNo}?rest=true
Response Model
Specifications
Scoreboard Object
Field Name
Type
Description
OPTIONAL
tournamentId
integer
tournament identifier
timestamp
time
Time at which the scorecard feed was generated in UTC
teamScores
array
see object docs
isOfficial
boolean
Indicates whether or not the scorecard updates for the given player are complete. Occurs when a player has completed competing in the tournament either from retiring or finishing all rounds.
seqNum
integer
sequence number of the packet
scoringType
string
[Optional] is either "strokes" or "points"
YES
winningTeamNo
integer
identifier of the match winner; will be null until a winner is defined
YES
matchId
integer
match identifier
teamScores object
Field Name
Type
Description
Optional
matchTotalToPar
integer
[Optional] Integer, Score to par calculated for finished holes
YES
players
array
see object docs
matchPoints
Decimal
[Optional] Decimal, Score for team in match, usually it will be sum of points of MatchHoleScore points (available only for ScoringType set to Points)
YES
matchStrokes
integer
[Optional] Integer, Number of strokes taken in that match - based only on completed holes
YES
holeScores
array
see object docs
teamNo
integer
Team identifier
players object
Field Name
Type
Description
displayName
string
Name of the player
country
string
Country (3 upper case letters)
isAmateur
boolean
True if player is an amateur
lastName
string
Last name
firstName
string
First name
id
integer
Player ID
holescores object
Field Name
Type
Description
Optional
cumulativeScoreToPar
integer
[Optional] Integer, Contains cumulative number of strokes compared to par of current and previous holes
YES
yardage
integer
The length of the hole in yards
par
integer
Par value for the given hole
holeFinished
boolean
flag to determine if a given hole is finished
scoreToPar
integer
[Optional] integer, score to par on particular hole. This value will be empty when hole was not played yet or conceded
YES
points
double
The accumulated points score for that match
YES
holeFinishedBy
string
YES
cumulativeHolesAdvantage
string
YES
strokes
string
YES
holeNo
integer
Number of the hole
playOffSequence
integer
A counter indicating which playoff hole number the given hole pertains to, Will be 0 for non-playoff holes, and will count up from 1 for playoff holes
PlayerScores
array
Score per player on a given hole, this will be sent when teams are playing best ball (Four Balls) format so as to know the individual player score as well as the total team score
YES
PlayerScores Object
Field
Type
Description
Optional
Strokes
integer
number of strokes on a given hole
ScoreToPar
integer
score to par on a given hole
id
integer
player ID
isBallHoled
Boolean
Flag indicating whether the ball was holed
Ryder Cup Example
{"tournamentId": 357,"timestamp": "2021-09-24T15:54:32.702Z","teamScores": [{"matchTotalToPar": -3,"players": [{"displayName": "Jordan Spieth","country": "USA","isAmateur": false,"lastName": "Spieth","firstName": "Jordan","id": 3874},{"displayName": "Justin Thomas","country": "USA","isAmateur": false,"lastName": "Thomas","firstName": "Justin","id": 3782}],"matchPoints": 7,"matchStrokes": 64,"teamResult": "Lost","holeScores": [{"playOffSequence": 0,"cumulativeScoreToPar": 0,"yardage": 333,"par": 4,"holeFinished": true,"scoreToPar": 0,"points": 0.5,"holeFinishedBy": "BallHoled","cumulativeHolesAdvantage": "T","strokes": "4","holeNo": 1},{"playOffSequence": 0,"yardage": 471,"par": 4,"holeFinished": false,"holeNo": 18}],"teamNo": 26}],"isOfficial": true,"seqNum": 73,"scoringType": "Points","winningTeamNo": 26,"matchId": 1001}
Last updated