For the complete documentation index, see llms.txt. This page is also available as Markdown.

Standard Stroke Event

Overview

These events describe the stroke-by-stroke flow on a hole.

sr_group_id and group_number are present only for stroke play tournaments.

Shared player fields

The player object uses these fields across all stroke events:

Name

Type

Description

Old IMGA API equivalent

player.player_id

Integer

Numeric player identifier.

playerId

player.sr_player_id

String

SR player identifier.

-

player.country

String

Three-letter country code.

player.country

player.display_name

String

Full display name.

player.displayName

player.first_name

String

First name.

player.firstName

player.last_name

String

Last name.

player.lastName

player.is_amateur

Boolean

Amateur flag.

player.isAmateur

player.gender

String

Player gender.

player.gender

Stroke Preparation

IMGA equivalent: Addressing Ball

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

-

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

stroke_number

Integer

Stroke number on the hole.

Yes

strokeNo

provisional_number

Integer

Provisional ball sequence.

Yes

provisionalIndex

club_type

String (ENUM)

Club type. Example values: DRIVER, FAIRY_WOOD, IRON.

Yes

clubTypeCode

player

Object

Player details. See shared player fields.

Yes

-

Stroke Executed

IMGA equivalent: Hit Ball

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

-

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

stroke_number

Integer

Stroke number on the hole.

Yes

strokeNo

strokes_assessed

Integer

Number of strokes applied by this action.

Yes

strokesAssessed

provisional_number

Integer

Provisional ball sequence.

Yes

provisionalIndex

player

Object

Player details. See shared player fields.

Yes

-

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

Possible Stroke Location

IMGA equivalent: Approximate Ball Lie

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

-

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

stroke_number

Integer

Stroke number on the hole.

Yes

strokeNo

stroke_executed_event_id

String (UUID)

Identifier of the related StrokeExecuted event.

Yes

-

in_the_hole

Boolean

Whether the ball may be holed.

Yes

inTheHole

player

Object

Player details. See shared player fields.

Yes

-

ball_lie.coordinates

Object

Ball coordinates in meters.

Yes

ballLie.coordinates

ball_lie.is_prediction_unconfident

Boolean

Prediction confidence flag.

Yes

ballLie.isPredictionUnconfident

ball_lie.is_water_probable

Boolean

Water hazard probability flag.

Yes

ballLie.isWaterProbable

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

Stroke Location

IMGA equivalent: Detailed Ball Lie

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

-

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

stroke_number

Integer

Stroke number on the hole.

Yes

strokeNo

stroke_executed_event_id

String (UUID)

Identifier of the related StrokeExecuted event.

Yes

-

in_the_hole

Boolean

Whether the ball ended in the hole.

Yes

inTheHole

player

Object

Player details. See shared player fields.

Yes

-

ball_lie.coordinates

Object

Ball coordinates in meters.

Yes

ballLie.coordinates

ball_lie.is_next_stroke_obstructed

Boolean

Whether the next stroke is obstructed.

Yes

ballLie.obstructions

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

Ball Holed

IMGA equivalent: Ball Holed

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

-

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

stroke_number

Integer

Stroke number on the hole.

Yes

strokeNo

stroke_executed_event_id

String (UUID)

Identifier of the related StrokeExecuted event.

Yes

-

player

Object

Player details. See shared player fields.

Yes

-

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

Last updated

Was this helpful?