Ball Drops and Penalty Events

Overview

These events cover drops and penalty assessment.

sr_group_id and group_number are present only for stroke play tournaments.

Ball Dropped

IMGA equivalent: Ball Drop

Event.Sport.Golf.BallDropped

{
  "data": {
    "type": "Event.Sport.Golf.BallDropped",
    "payload": {
      "event_time": "2026-04-24T11:09:15.267Z",
      "team_id": 12345,
      "sr_team_id": "sr:competitor:12345",
      "player_id": 22,
      "sr_player_id": "sr:competitor:22",
      "sr_group_id": "sr:group_match:12345",
      "group_number": 1,
      "hole_number": 3,
      "hole_sequence": 3,
      "course_id": 42178,
      "sr_course_id": "sr:venue:42178",
      "round_number": 1,
      "ball_lie": {
        "coordinates": {
          "x": 10900.307,
          "y": 10333.514,
          "z": 12.541
        },
        "distance_hit": 150.5,
        "distance_to_pin": 10.2,
        "zone": "GREEN"
      }
    }
  }
}

Name	Type	Description	Required	Old IMGA API equivalent
event_time	String (date-time)	Time when the event occurred.	Yes	timestamp
team_id	Integer	Numeric team identifier.	Yes	teamNo
sr_team_id	String	SR team identifier.	Yes	-
player_id	Integer	Numeric player identifier.	Yes	playerId
sr_player_id	String	SR player identifier.	Yes	-
sr_group_id	String	SR group identifier.	No	-
group_number	Integer	Group number.	No	groupNo
hole_number	Integer	Hole number.	Yes	holeNo
hole_sequence	Integer	Hole order on the course.	Yes	holeOrder
course_id	Integer	Numeric course identifier.	Yes	courseId
sr_course_id	String	SR course identifier.	Yes	-
round_number	Integer	Round number.	Yes	roundNo
ball_lie.coordinates	Object	Ball coordinates in meters.	Yes	ballLie.coordinates
ball_lie.distance_hit	Number	Distance travelled in meters.	Yes	ballLie.shotDistance
ball_lie.distance_to_pin	Number	Distance to pin in meters.	Yes	ballLie.distanceToPin
ball_lie.zone	String (ENUM)	Landing zone.	Yes	ballLie.surfaceType

Penalty

IMGA equivalent: Penalty

Event.Sport.Golf.Penalty

{
  "data": {
    "type": "Event.Sport.Golf.Penalty",
    "payload": {
      "event_time": "2026-04-24T11:09:15.267Z",
      "team_id": 12345,
      "sr_team_id": "sr:competitor:12345",
      "player_id": 22,
      "sr_player_id": "sr:competitor:22",
      "sr_group_id": "sr:group_match:12345",
      "group_number": 1,
      "hole_number": 3,
      "hole_sequence": 3,
      "course_id": 42178,
      "sr_course_id": "sr:venue:42178",
      "round_number": 1,
      "strokes_assessed": 2,
      "score": {
        "hole_par": 4,
        "hole_strokes": 3,
        "sport_event_score_to_par": -1,
        "tournament_score_to_par": -1
      }
    }
  }
}

Name	Type	Description	Required	Old IMGA API equivalent
event_time	String (date-time)	Time when the event occurred.	Yes	timestamp
team_id	Integer	Numeric team identifier.	Yes	teamNo
sr_team_id	String	SR team identifier.	Yes	-
player_id	Integer	Numeric player identifier.	Yes	playerId
sr_player_id	String	SR player identifier.	Yes	-
sr_group_id	String	SR group identifier.	No	-
group_number	Integer	Group number.	No	groupNo
hole_number	Integer	Hole number.	Yes	holeNo
hole_sequence	Integer	Hole order on the course.	Yes	holeOrder
course_id	Integer	Numeric course identifier.	Yes	courseId
sr_course_id	String	SR course identifier.	Yes	-
round_number	Integer	Round number.	Yes	roundNo
strokes_assessed	Integer	Number of penalty strokes assessed.	Yes	penaltyStrokes
score.hole_par	Integer	Hole par.	Yes	score.currentHolePar
score.hole_strokes	Integer	Strokes taken on the hole.	Yes	score.currentHoleStrokes
score.sport_event_score_to_par	Integer	Score to par for the current round or match.	Yes	score.currentRoundScoreToPar
score.tournament_score_to_par	Integer	Overall tournament score to par.	Yes	score.overallScoreToPar