Hole Events

Overview

Hole events mark the start and completion of a hole.

sr_group_id and group_number are present only for stroke play tournaments.

Hole Started

IMGA equivalent: Hole Started

Event.Sport.Golf.HoleStarted

{
  "data": {
    "type": "Event.Sport.Golf.HoleStarted",
    "payload": {
      "event_time": "2026-04-24T11:09:15.267Z",
      "team_id": 12345,
      "sr_team_id": "sr:competitor:12345",
      "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
    }
  }
}

Name	Type	Description	Required	Old IMGA API equivalent
event_time	String (date-time)	Time when the hole began.	Yes	timestamp
team_id	Integer	Numeric team identifier.	Yes	teamNo
sr_team_id	String	SR team 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

Hole Ended

IMGA equivalent: Hole Finished

Event.Sport.Golf.HoleEnded

{
  "data": {
    "type": "Event.Sport.Golf.HoleEnded",
    "payload": {
      "event_time": "2026-04-24T11:09:15.267Z",
      "team_id": 12345,
      "sr_team_id": "sr:competitor:12345",
      "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,
      "end_reason": "BALL_HOLED",
      "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 hole ended.	Yes	timestamp
team_id	Integer	Numeric team identifier.	Yes	teamNo
sr_team_id	String	SR team 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
end_reason	String (ENUM)	Reason the hole ended. Possible values: BALL_HOLED, RESIGNED, WITHDRAWN, DISQUALIFIED, HOLE_CONCEDED, OTHER, HOLE_WON, HOLE_LOST.	Yes	finishReason
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