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

Match Play Schedule

Overview

Use this endpoint to retrieve the match play schedule for a given tournament_id.

The response includes all known matches, scheduled start details, current status, and assigned teams and players.

Request

URL

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

Path parameters

Name

Type

Required

Description

tournament_id

integer

Yes

Tournament identifier.

Example request

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

This endpoint returns matches that are already known for the tournament. New matches can appear as the schedule is updated.

Response example

Response fields

field
type
description
required
required in PGA
old IMGA API equivalent

matches

Array

Array of already known matches in the tournament

yes

array of groups was a root element of the response

matches[].match_id

Integer

Numeric ID of the match

yes

matchNo

matches[].sr_match_id

String

SR ID of the match

yes

-

matches[].date

Date

Date on which the match is played

yes

date

matches[].round_number

Integer

Round number in which the match is played

yes

round

matches[].starting_hole_number

Integer

Hole number where the match starts

yes

hole

matches[].position_in_sequence_of_groups_on_tee

Integer

Sequence of the match on the tee

yes

teeSeq

matches[].status

String

Status of the match. Possible values: NOT_STARTED, IN_PROGRESS, ENDED.

yes

status

matches[].start_time

Date time in UTC format

Scheduled match start time in UTC

yes

startTime.time

matches[].teams

Array

List of teams in the match

yes

teams

matches[].teams[].team_id

Integer

Numeric ID of the team

yes

teamNo

matches[].teams[].sr_team_id

String

SR ID of the team

yes

-

matches[].teams[].players

Array

List of players in the team

yes

players

matches[].teams[].players[].player_id

Integer

Numeric ID of the player

yes

playerId

matches[].teams[].players[].sr_player_id

String

SR ID of the player

yes

-

matches[].teams[].players[].country

String

3-character FIFA country code

yes

country

matches[].teams[].players[].display_name

String

Full player name used for display

yes

displayName

matches[].teams[].players[].first_name

String

First name of the player

yes

firstName

matches[].teams[].players[].last_name

String

Last name of the player

yes

lastName

matches[].teams[].players[].is_amateur

Boolean

Indicates whether the player is an amateur

yes

isAmateur

matches[].teams[].players[].player_pga_tour_id

String

PGA Tour player identifier

no

yes

playerPGATourId

Last updated

Was this helpful?