This endpoint is a live websocket endpoint that returns individual team hole-by-hole scores. Currently the whole json is sent whenever there is an update – this will look to be optimised in the future to just send new data (deltas). You should receive a new update any time a player completes a hole, and their total strokes and “to par” score for the day changes.
The authentication token provided will be required to make a connection to this websocket endpoint.
This endpoint currently takes no request parameters, we aim to add them, and once we have they will be detailed here.
team number of player (players are usually in a team of 1)
roundScores
object
See object docs
playOffScore
object
See object docs. Only for playoff rounds
isOfficial
boolean
Have the scores been officialised
Players object
Field Name
Type
Description
displayName
string
Name of the player
Country
string
Country of the player
isAmateur
boolean
True if player is an amateur
lastName
string
Last name
firstName
string
First name
gender
string
Gender of player
id
integer
Player ID
roundScores Object
Field Name
Type
Description
1- 4+ playoff (round)
object
The object in which the round score information is included
roundScores 1-4 (round) Object
Field Name
Type
Description
holes
object
See object docs
inScore
object
See object docs
outScore
object
See object docs
roundPar
object
Includes value and roundPar of the par score for that round. See object docs
roundScore
object
Includes value and roundScore of the score for that team for that round. See object docs
roundToPar
object
Includes value and roundToPar for the team's overall to par score for that round. See object docs
Holes object
Field Name
Type
Description
1- 18 (holes)
object
See object docs
1-18 holes object
Field Name
Type
Description
holeScore
integer
The to par score for that team in that hole
holePar
integer
The par score for that hole
holeOrder
integer
How many holes into their round is the team
holeYardage
integer
The length of the hole in yards
holeStrokes
integer
The number of strokes that the team did on that hole
inScore Object
Field Name
Type
Description
par
integer
The par score for the last 9 holes of the course
score
integer
The to par score for the last 9 holes of the course
strokes
integer
The number of strokes that the team did on the last 9 holes of the course
yardage
integer
The length of the last 9 holes in yards
outScore Object
Field Name
Type
Description
par
integer
The par score for the first 9 holes of the course
score
integer
The to par score for the first 9 holes of the course
strokes
integer
The number of strokes that the team did on the first 9 holes of the course
yardage
integer
The length of the first 9 holes in yards
roundToPar object
Field Name
Type
Description
value
integer
Player's score relative to par on the current round
displayValue
string
Player's score relative to par on the current round
roundScore object
Field Name
Type
Description
value
integer
Player's score on the current round
displayValue
string
Player's score on the current round
roundPar object
Field Name
Type
Description
value
integer
Score for a round required for a player to make par
displayValue
string
Score for a round required for a player to make par
Sample Output
Playoffs
Playoff holebyholes work in the same way, to the above holebybhole, however they are sent as a new object with a playOffScore on the same level as roundScores.
See below for an example from the Sony Open in Hawaii 2025 playoff:
