Schedule

Overview

Use this endpoint to retrieve the full tournament schedule in one response.

Stroke play rounds appear in stroke_play.groups. Match play rounds appear in match_play.matches.

A tournament can use one format or both. Unused format sections return an empty array.

Request

URL

GET https://{domain}/golf/rest/v1/tournaments/{tournament_id}/schedule

Path parameters

Name	Type	Required	Description
tournament_id	integer	Yes	ID of the tournament whose schedule is returned.

Example request

Get a tournament schedule

GET /golf/rest/v1/tournaments/12345/schedule HTTP/1.1
Host: {domain}
Authorization: Bearer <JWT_TOKEN>

Groups and matches can appear as the schedule is updated.

Response example

{
  "stroke_play": {
    "groups": [
      {
        "sr_group_id": "sr:group_match:294222",
        "group_number": 10,
        "date": "2026-05-13",
        "round_number": 1,
        "start_hole": 10,
        "course_id": 12345,
        "position_in_sequence_of_groups_on_tee": 1,
        "status": "NOT_STARTED",
        "start_time": "2026-05-13T10:00:00Z",
        "teams": [
          {
            "team_id": 2942221,
            "sr_team_id": "sr:team:2942221",
            "order_within_group": 1,
            "players": [
              {
                "player_id": 22,
                "sr_player_id": "sr:competitor:22",
                "country": "ENG",
                "display_name": "Tommy Fleetwood",
                "first_name": "Tommy",
                "last_name": "Fleetwood",
                "is_amateur": false,
                "player_pga_tour_id": "30911"
              }
            ]
          }
        ]
      }
    ]
  },
  "match_play": {
    "matches": [
      {
        "match_id": 294222,
        "sr_match_id": "sr:match:294222",
        "date": "2026-05-13",
        "round_number": 1,
        "start_hole": 10,
        "course_id": 12345,
        "position_in_sequence_of_matches_on_tee": 1,
        "status": "NOT_STARTED",
        "start_time": "2026-05-13T10:00:00Z",
        "teams": [
          {
            "team_id": 2942221,
            "sr_team_id": "sr:team:2942221",
            "order_within_match": 1,
            "players": [
              {
                "player_id": 22,
                "sr_player_id": "sr:competitor:22",
                "country": "ENG",
                "display_name": "Tommy Fleetwood",
                "first_name": "Tommy",
                "last_name": "Fleetwood",
                "is_amateur": false,
                "player_pga_tour_id": "30911"
              }
            ]
          }
        ]
      }
    ]
  }
}

Stroke play response fields

Field	Type	Description	Required	Required in PGA	Old IMGA API equivalent
stroke_play.groups	array	Known groups in the tournament.	Yes		Root response array
groups[].sr_group_id	string	Group ID in SR format.	Yes		-
groups[].group_number	integer	Group number within the round.	Yes		groupNo
groups[].date	date	Day the group plays.	Yes		date
groups[].round_number	integer	Round number.	Yes		round
groups[].start_hole	integer	Starting hole number.	Yes		hole
groups[].course_id	integer	ID of the course used by the group.	Yes		courseId
groups[].position_in_sequence_of_groups_on_tee	integer	Sequence on the tee.	Yes		teeSeq
groups[].status	string (enum)	NOT_STARTED, IN_PROGRESS, or ENDED.	Yes		status
groups[].start_time	UTC date-time	Scheduled round start time.	Yes		startTime.time
groups[].teams	array	Teams in the group.	Yes		teams
groups[].teams[].team_id	integer	Numeric team ID.	Yes		teamNo
groups[].teams[].sr_team_id	string	Team ID in SR format.	Yes		-
groups[].teams[].order_within_group	integer	Order in which the team starts within the group.	Yes		-
groups[].teams[].players	array	Players in the team.	Yes		players
groups[].teams[].players[].player_id	integer	Numeric player ID.	Yes		playerId
groups[].teams[].players[].sr_player_id	string	Player ID in SR format.	Yes		-
groups[].teams[].players[].country	string	ISO alpha-3 country code.	Yes		country
groups[].teams[].players[].display_name	string	Full display name.	Yes		displayName
groups[].teams[].players[].first_name	string	First name.	Yes		firstName
groups[].teams[].players[].last_name	string	Last name.	Yes		lastName
groups[].teams[].players[].is_amateur	boolean	true for amateur players.	Yes		isAmateur
groups[].teams[].players[].player_pga_tour_id	integer	PGA Tour player ID.	No	Yes	playerPGATourId

Match play response fields

Field	Type	Description	Required	Required in PGA	Old IMGA API equivalent
match_play.matches	array	Known matches in the tournament.	Yes		Root response array
matches[].match_id	integer	Numeric match ID.	Yes		matchNo
matches[].sr_match_id	string	Match ID in SR format.	Yes		-
matches[].date	date	Day the match is played.	Yes		date
matches[].round_number	integer	Round number.	Yes		round
matches[].start_hole	integer	Starting hole number.	Yes		hole
matches[].course_id	integer	ID of the course used by the match.	Yes		courseId
matches[].position_in_sequence_of_matches_on_tee	integer	Sequence on the tee.	Yes		teeSeq
matches[].status	string (enum)	NOT_STARTED, IN_PROGRESS, or ENDED.	Yes		status
matches[].start_time	UTC date-time	Scheduled match start time.	Yes		startTime.time
matches[].teams	array	Teams in the match.	Yes		teams
matches[].teams[].team_id	integer	Numeric team ID.	Yes		teamNo
matches[].teams[].sr_team_id	string	Team ID in SR format.	Yes		-
matches[].teams[].order_within_match	integer	Order in which team(competitior) starts within match	Yes		-
matches[].teams[].players	array	Players in the team.	Yes		players
matches[].teams[].players[].player_id	integer	Numeric player ID.	Yes		playerId
matches[].teams[].players[].sr_player_id	string	Player ID in SR format.	Yes		-
matches[].teams[].players[].country	string	ISO alpha-3 country code.	Yes		country
matches[].teams[].players[].display_name	string	Full display name.	Yes		displayName
matches[].teams[].players[].first_name	string	First name.	Yes		firstName
matches[].teams[].players[].last_name	string	Last name.	Yes		lastName
matches[].teams[].players[].is_amateur	boolean	true for amateur players.	Yes		isAmateur
matches[].teams[].players[].player_pga_tour_id	integer	PGA Tour player ID.	No	Yes	playerPGATourId

Related endpoints

• Tournaments list
• Single Tournament
• Entrylist