Play By Play Shot Commentary

This endpoint returns play by play (PBP) shot commentary to be used for significant stroke play and match play events.

Endpoint URL

wss://dde-streams.data.imgarena.com/golf/tournaments/{tournamentId}/pbpcommentary/holes/{holeno}

The authentication token provided will be required to make a connection to this websocket endpoint.

Sample Endpoint URL for The American Express 2025 for hole 2:

wss://dde-streams.data.imgarena.com/golf/tournaments/1092/pbpcommentary/holes/2

Process for connecting to the web socket endpoints

• Connect to SSL websocket address

• Send JSON packet containing API token

• Receive response indicating that connection is authorised (or a response indicating why the connection cannot be made)

• Receive heartbeat packets every 10 seconds to verify the connection is live

• Receive data packets

Once you have the API token, any further data that you send over the connection will be ignored.

Request Parameters

This endpoint currently takes no request parameters currently.

Response Model

Field Name	Type	Description
distanceToPinYards	float	Distance in yards from the player's current ball position to the pin of the hole
groupNo	integer	The group number of the player, shared with who they are playing their round with
holeNo	integer	The current Hole Number the event took place on. Holes 1 - 18
latestStrokeNo	int	The nth shot/stroke on the current hole.
pbpCommentary	string	Generated text commentary relative to the shot in question and the surrounding situation of the player's shot
playerId	integer	The internal ID of the Player of the current event
tournamentId	integer	The unique Tournament ID of the current event
roundNumber	integer	The current Round Number the event took place on. Usually would be 1 to 4
playerName	string	The first name and surname of the player
prevDistanceToPinYards	float	Distance in yards from the player's previous ball position from their previous shot to the pin of the hole. This field can be optional
teamNumber	integer	The player's Team Number for the current Tournament format
shotFromLocation	string	The description of the location on the hole from where the player took their most recent shot, e.g. rough, fairway, bunker, tee
shotToLocation	string	The description of the location on the hole from where the player's ball has landed after their most recent shot, e.g. rough, fairway, bunker, green
latestPlayed	Binary	1 = This player within the group was the last to play. 0 = This player within the group was not the last to play.
nextToPlay	Binary	1 = This player within the group is next to play. 0 = This player within the group is not the next to play.
timestamp	timestamp	The time stamp of this action.
tournamentScoreToPar	string	The overall player score to par for that tournament. This can be "E" if there are no scoreToPar
groupHoleStartedTimestamp	timestamp	The timestamp of the group on the hole
currentHoleOrder	integer	The current hole order
externalPlayerId	integer	The external player id. This field can be optional

Sample Response for Stroke Play

{
    "tournamentId": 3369
    "holeNo": 6,
    "seqNum": 799,
    "timestamp": "2025-12-04T15:41:38.000Z",
    "pbpComments": [
        {
            "currentHoleOrder": 1,
            "distanceToPinYards": 138.33836216373763,
            "groupHoleStartedTimestamp": "2025-12-04T15:38:52.000Z",
            "groupNo": 21,
            "holeNo": 6,
            "latestPlayed": 1,
            "latestStrokeNo": 1,
            "nextToPlay": 0,
            "pbpCommentary": "Shot 1: 271yds to Fairway, 138yds to pin",
            "playerId": 27,
            "playerName": "Lee Westwood",
            "prevDistanceToPinYards": 418.0,
            "roundNumber": 4,
            "shotFromLocation": "Tee Box",
            "shotToLocation": "Fairway",
            "teamNumber": 11,
            "timestamp": "2025-12-04T15:41:38.000Z",
            "tournamentId": 3369,
            "tournamentScoreToPar": "-5"
        },
        {
            "currentHoleOrder": 1,
            "distanceToPinYards": 144.99704093028825,
            "groupHoleStartedTimestamp": "2025-12-04T15:38:52.000Z",
            "groupNo": 21,
            "holeNo": 6,
            "latestPlayed": 0,
            "latestStrokeNo": 1,
            "nextToPlay": 0,
            "pbpCommentary": "Shot 1: 264yds to Fairway, 145yds to pin",
            "playerId": 3,
            "playerName": "Matt Wallace",
            "prevDistanceToPinYards": 418.0,
            "roundNumber": 4,
            "shotFromLocation": "Tee Box",
            "shotToLocation": "Fairway",
            "teamNumber": 6,
            "timestamp": "2025-12-04T15:40:31.000Z",
            "tournamentId": 3369,
            "tournamentScoreToPar": "-4"
        }
    ]
}