# Standard Stroke Events ### Addressing Ball This event will be sent when a player is about to hit the ball, i.e, they are standing over the ball literally about to take their stroke. **Addressing Ball Object** | Field Name | Type | Description | | ----------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | seqNum | integer | The sequence number of the packet. | | groupId | integer | The group ID of the player who did the event | | groupNo | integer | \[Optional] The group number of the player who did the event | | teamNo | integer | The team number of the player who did the event | | playerId | integer | The player ID of the player who did the event | | holeNo | integer | The hole in which the event took place | | holeOrder | integer | The hole order of the hole in which the event took place (e.g. if a player starts a round on hole 10, this will be 1) – always starts at 1 and ends on 18 | | courseId | integer | The ID of the course where the event took place | | strokeNo | integer | The stroke associated with the event | | timestamp | date | The timestamp of the event, in UTC | | timestampReceived | date | The server time of the moment that this packet has been processed | | eventElementType | string |

The type of event, in this case AddressingBall.

Full list of values include:

| | provisionalIndex | integer | indicates if the event is part of a provisional ball. 0 if not, 1 if first provisional ball, 2 if second provisional ball for that stroke, e.t.c… | | player | object | See object below | | clubTypeCode | string | This is the type of Club a player used for the shot. NB. this is only populated for Drives. | | roundNo | integer | The current round number | #### Player Object
Field NameTypeDescription
displayNamestringThe full name or display name of that player
countrystringThe affiliated country (typically birthplace)
genderstringThe gender of player
isAmateurstringIs that player an amateur or not (true/false)
lastNamestringThe surname of the player
firstNamestringThe forename of that player
idIntegerThe Player unique Id
**Club Types** | **clubTypeCode** | **Description** | | ---------------- | --------------- | | CDR | Driver | | CFW | Fairway Wood | | CIR | Iron | | CUK | Unknown |
**Sample Event Packet:** ``` { "clubTypeCode": "CUK", "courseId": "416", "eventElementType": "AddressingBall", "groupId": 1211189, "groupNo": 12, "holeNo": 11, "holeOrder": 2, "player": { "country": "JPN", "displayName": "Ryo Hisatsune", "firstName": "Ryo", "gender": "male", "id": 8382, "isAmateur": false, "lastName": "Hisatsune" }, "playerId": 8382, "provisionalIndex": 0, "roundNo": 1, "seqNum": 24, "strokeNo": 2, "teamNo": 99, "timestamp": "2025-02-20T13:50:59.760Z", "timestampReceived": "2025-02-20T13:51:01.446Z" } ``` ### Hit Ball This event will be sent as soon as the player has hit the ball. **Hit Ball Object** | Field Name | Type | Description | | ----------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | seqNum | integer | The sequence number of the packet. | | groupID | integer | The group ID of the player who did the event | | groupNo | integer | \[Optional] The group number of the player who did the event | | teamNo | integer | The team number of the player who did the event | | playerId | integer | The player ID of the player who did the event | | holeNo | integer | The hole in which the event took place | | holeOrder | integer | The hole order of the hole in which the event took place (e.g. if a player starts a round on hole 10, this will be 1) – always starts at 1 and ends on 18 | | courseId | integer | The ID of the course where the event took place | | strokeNo | integer | The stroke associated with the event | | timestamp | date | The timestamp of the event, in UTC | | timestampReceived | date | The server time of the moment that this packet has been processed | | eventElementType | string |

The type of event, in this case HitBall

Full list of values include:

| | provisionalIndex | integer | indicates if the event is part of a provisional ball. 0 if not, 1 if first provisional ball, 2 if second provisional ball for that stroke, e.t.c… | | player | object | See object below | | roundNo | integer | round number of the event | | score | object | See object below | #### Player Object
Field NameTypeDescription
displayNamestringThe full name or display name of that player
countrystringThe affiliated country (typically birthplace)
isAmateurstringIs that player an amateur or not (true/false)
genderstringthe gender of the player
lastNamestringThe surname of the player
firstNamestringThe forename of that player
idIntegerThe Player unique Id
\ **Score Object** | Field Name | Type | Description | | ---------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | currentHoleStrokes | integer | The number of strokes that the team is on for that hole; Can be greater than ‘stroke’ above in the instance that the team has been awarded a penalty | | currentHolePar | integer | The par score for the current hole | | currentRoundScoreToPar | object | The team’s current ‘To Par’ score for the current round | | overallScoreToPar | object | The team’s current ‘To Par’ score for the tournament | \ **Sample Event Packet:** ``` { "courseId": "416", "eventElementType": "HitBall", "groupId": 1211189, "groupNo": 12, "holeNo": 11, "holeOrder": 2, "player": { "country": "JPN", "displayName": "Ryo Hisatsune", "firstName": "Ryo", "gender": "male", "id": 8382, "isAmateur": false, "lastName": "Hisatsune" }, "playerId": 8382, "provisionalIndex": 0, "roundNo": 1, "score": { "currentHolePar": 3, "currentHoleStrokes": 0, "currentRoundScoreToPar": "0", "overallScoreToPar": "0" }, "seqNum": 25, "strokeNo": 2, "strokesAssessed": 1, "teamNo": 99, "timestamp": "2025-02-20T13:51:00.941Z", "timestampReceived": "2025-02-20T13:51:02.669Z" } ``` ### Approximate Ball Lie This will be sent as soon as we have any information on the lie of the ball. It is approximate because it assumes the data collector has not been able to get to where the ball has landed on the course, and will be estimating it’s lie based on a map. **Approximate Ball Lie Object** | Field Name | Type | Description | | ----------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | seqNum | integer | The sequence number of the packet. | | strokesAssessed | integer | Default as 1. | | groupID | integer | The group ID of the player who did the event | | groupNo | integer | \[Optional] The group number of the player who did the event | | teamNo | integer | The team number of the player who did the event | | playerId | integer | The player ID of the player who did the event | | holeNo | integer | The hole in which the event took place | | holeOrder | integer | The hole order of the hole in which the event took place (e.g. if a player starts a round on hole 10, this will be 1) – always starts at 1 and ends on 18 | | courseId | integer | The ID of the course where the event took place | | strokeNo | integer | The stroke associated with the event | | timestamp | date | The timestamp of the event, in UTC | | timestampReceived | date | The server time of the moment that this packet has been processed | | eventElementType | string |

The type of event, in this case ApproximateLie

Full list of values include:

| | ballLie | object | See object below | | player | object | See object below | | provisionalIndex | integer | indicates if the event is part of a provisional ball. 0 if not, 1 if first provisional ball, 2 if second provisional ball for that stroke, e.t.c… | | inTheHole | boolean | allows to notify downstream that there has been a possible hole in one on the packet (so operators can suspend markets), but then confirmation will come thereafter | \ **Ball Lie Object**
Field NameTypeDescription
Field NameTypeDescription
coordinatesobjectSee object below
shotDistancedecimalHow far the shot went for that stroke. Data returned in meters.
distanceToPinintegerHow far the ball is from the pin. Data returned in meters
surfaceTypestring

Text string which describes the lie of the ball, can be inconsistent across different data collection systems / Tours. We recommend using the 3 letter codes.

See Surface Types table below.

surfaceTypeCodestring

3 letter enum code which describes the lie of the ball.

See Surface Types table below.

obstructionsbooleantrue if the team has an obstruction next to the ball that makes the ball hard to hit
blindshotbooleantrue if the team cannot see the pin from where they are taking the shot
distanceToPinProbarraydistance to ping probability - only for PGA events
isPredictionUnconfidentboolean
isWaterProbablebooleanif the ball is in the water - only for PGA events
strokesToPinProbarraystrokes to ping probability - only for PGA events
**coordinates object:** | Field | Type | Description | | ----- | ------- | ------------------------- | | x | decimal | X co-ordinate of the ball | | y | decimal | Y co-ordinate of the ball | | z | decimal | Z co-ordinate of the ball | Surface Types: | **surfaceTypeCode** | **surfaceType** | | ------------------- | --------------------- | | OFW | Fairway | | OGR | Green | | OIR | IntermediateRough | | ORO | Rough or PrimaryRough | | OST | FairwayBunker | | OGS | Greenside Bunker | | OCO | Fringe | | ONA | NativeArea | | OTO | Trees or TreeOutline | | OBU | Bushes | | ODS | Desert | | OWA | Water | | OTH | Other | | OCA | CartPath | | ODO | Dirt or DirtOutline | | OTF | OtherFairway | | OOB | OutOfBounds | | OWB | WasteBunker | | OUK | Unknown | #### Player Object
Field NameTypeDescription
displayNamestringThe full name or display name of that player
countrystringThe affiliated country (typically birthplace)
genderstringThe gender of the player
isAmateurstringIs that player an amateur or not (true/false)
lastNamestringThe surname of the player
firstNamestringThe forename of that player
idIntegerThe Player unique Id
\ **Sample Event Packet:** ``` { "ballLie": { "blindShot": false, "coordinates": { "x": 10900.307, "y": 10333.514, "z": 12.541 }, "distanceToPin": 1.473, "distanceToPinProb": null, "isPredictionUnconfident": null, "isWaterProbable": null, "obstructions": false, "shotDistance": 117.094, "strokesToPinProb": null, "surfaceType": "Green", "surfaceTypeCode": "OGR" }, "courseId": "416", "eventElementType": "ApproximateLie", "groupId": 1211189, "groupNo": 12, "holeNo": 12, "holeOrder": 3, "inTheHole": true, "player": { "country": "JPN", "displayName": "Ryo Hisatsune", "firstName": "Ryo", "gender": "male", "id": 8382, "isAmateur": false, "lastName": "Hisatsune" }, "playerId": 8382, "provisionalIndex": 0, "roundNo": 1, "seqNum": 57, "strokeNo": 3, "strokesAssessed": 1, "teamNo": 99, "timestamp": "2025-02-20T14:07:42.003Z", "timestampReceived": "2025-02-20T14:07:44.047Z" } ``` ### Detailed Ball Lie This will be sent as soon as we have more detailed information on the lie of the ball – I.e the data collector has been able to walk over to the lie of the ball and give the exact GPS location of the ball. **Detailed Ball Lie Object** | Field Name | Type | Description | | ----------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ballLie | object | See object below | | seqNum | integer | The sequence number of the packet. | | strokesAssessed | integer | Default as 1. | | groupNo | integer | \[Optional] The group number of the player who did the event | | groupId | integer | the group Id of the player who did the event | | teamNo | integer | The team number of the player who did the event | | playerId | integer | The player ID of the player who did the event | | player | object | See object below | | holeNo | integer | The hole in which the event took place | | holeOrder | integer | The hole order of the hole in which the event took place (e.g. if a player starts a round on hole 10, this will be 1) – always starts at 1 and ends on 18 | | courseId | integer | The ID of the course where the event took place | | strokeNo | integer | The stroke associated with the event | | timestamp | date | The timestamp of the event, in UTC | | timestampReceived | date | The server time of the moment that this packet has been processed | | eventElementType | string |

The type of event, in this case DetailedLie

Full list of values include:

| | provisionalIndex | integer | indicates if the event is part of a provisional ball. 0 if not, 1 if first provisional ball, 2 if second provisional ball for that stroke, e.t.c… | | roundNo | integer | round number of the event | | inTheHole | boolean | allows to notify downstream that there has been a possible hole in one on the packet (so operators can suspend markets), but then confirmation will come thereafter | \ **Ball Lie Object** | Field Name | Type | Description | | --------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | coordinates | decimal | Z co-ordinate of the ball | | shotDistance | integer | How far the shot went for that stroke. Data returned in meters | | distanceToPin | integer | How far the ball is from the pin. Data returned in meters | | surfaceType | string |

Text string which describes the lie of the ball, can be inconsistent across different data collection systems / Tours. We recommend using the 3 letter codes.

See Surface Types table above.

| | surfaceTypeCode | string |

3 letter enum code which describes the lie of the ball.

See Surface Types table above.

| | obstructions | boolean | true if the team has an obstruction next to the ball that makes the ball hard to hit | | blindshot | boolean | true if the team cannot see the pin from where they are taking the shot | **coordinates object:** | Field | Type | Description | | ----- | ------- | ------------------------- | | x | decimal | X co-ordinate of the ball | | y | decimal | Y co-ordinate of the ball | | z | decimal | Z co-ordinate of the ball | #### Player Object
Field NameTypeDescription
displayNamestringThe full name or display name of that player
countrystringThe affiliated country (typically birthplace)
isAmateurstringIs that player an amateur or not (true/false)
genderstringThe gender of the player
lastNamestringThe surname of the player
firstNamestringThe forename of that player
idIntegerThe Player unique Id
\ **Sample Event Packet:** ``` { "ballLie": { "blindShot": false, "coordinates": { "x": 10900.729, "y": 10340.198, "z": 12.469 }, "distanceToPin": 2.692, "obstructions": false, "shotDistance": 119.075, "surfaceType": "Green", "surfaceTypeCode": "OGR" }, "courseId": "416", "eventElementType": "DetailedLie", "groupId": 1211189, "groupNo": 12, "holeNo": 12, "holeOrder": 3, "inTheHole": true, "player": { "country": "JPN", "displayName": "Ryo Hisatsune", "firstName": "Ryo", "gender": "male", "id": 8382, "isAmateur": false, "lastName": "Hisatsune" }, "playerId": 8382, "provisionalIndex": 0, "roundNo": 1, "seqNum": 58, "strokeNo": 3, "strokesAssessed": 1, "teamNo": 99, "timestamp": "2025-02-20T14:07:48.961Z", "timestampReceived": "2025-02-20T14:07:50.228Z", "websocket": { "timestamp": 2994963.799999997, "id": "wss://dde-streams.data.imgarena.com/golf/tournaments/1097/round/1/team/99" }, "isRowAccordionOpen": {} } ``` ### Ball Holed Will be sent when the ball has been holed. **Ball Holed Object** | Field Name | Type | Description | | ----------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | seqNum | integer | The sequence number of the packet. | | strokesAssessed | integer | Default as 1. | | groupId | integer | The group Id of the player who did the event | | groupNo | integer | \[Optional] The group number of the player who did the event | | teamNo | integer | The team number of the player who did the event | | playerId | integer | The player ID of the player who did the event | | holeNo | integer | The hole in which the event took place | | holeOrder | integer | The hole order of the hole in which the event took place (e.g. if a player starts a round on hole 10, this will be 1) – always starts at 1 and ends on 18 | | courseId | integer | The ID of the course where the event took place | | strokeNo | integer | The stroke associated with the event | | timestamp | date | The timestamp of the event, in UTC | | timestampReceived | date | The server time of the moment that this packet has been processed | | eventElementType | string |

The type of event, in this case BallHoled

Full list of values include:

| | score | object | See object below | | roundNo | integer | round number in the event | | player | object | see object below | | provisionalIndex | integer | indicates if the event is part of a provisional ball. 0 if not, 1 if first provisional ball, 2 if second provisional ball for that stroke, e.t.c… | \ Player Object
Field NameTypeDescription
displayNamestringThe full name or display name of that player
countrystringThe affiliated country (typically birthplace)
isAmateurstringIs that player an amateur or not (true/false)
genderstringThe gender of the player
lastNamestringThe surname of the player
firstNamestringThe forename of that player
idIntegerThe Player unique Id
**Score Object** | Field Name | Type | Description | | ------------------ | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | | currentHoleStrokes | integer | The number of strokes that the team is on for that hole; Can be greater than ‘stroke’ above in the instance that the team has been awarded a penalty | | currentHolePar | integer | The par score for the current hole | | currentRoundScore | object | The team’s current ‘To Par’ score for the current round | | overallScore | object | The team’s current ‘To Par’ score for the tournament | \ **Sample Event Packet** ``` { "courseId": "416", "eventElementType": "BallHoled", "groupId": 1211189, "groupNo": 12, "holeNo": 12, "holeOrder": 3, "player": { "country": "JPN", "displayName": "Ryo Hisatsune", "firstName": "Ryo", "gender": "male", "id": 8382, "isAmateur": false, "lastName": "Hisatsune" }, "playerId": 8382, "provisionalIndex": 0, "roundNo": 1, "score": { "currentHolePar": 5, "currentHoleStrokes": 0, "currentRoundScoreToPar": "0", "overallScoreToPar": "0" }, "seqNum": 65, "strokeNo": 5, "strokesAssessed": 1, "teamNo": 99, "timestamp": "2025-02-20T14:12:36.665Z", "timestampReceived": "2025-02-20T14:12:38.630Z" } ``` ## Doc navigation [← Hole: Started / Finished](/golf/round-details-scenarios/hole-started-finished.md)[Penalty Stroke →](broken://pages/-LuN9LL9heV4OVTHjeAB) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sportradar.com/golf/round-details-scenarios/standard-stroke-events.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.