Tee Times Per Round

get

https://api.sportradar.com/golf/{access_level}/{golf_tour}/v3/{language_code}/{season_year}/tournaments/{tournament_id}/{round_type}/{round_number}/teetimes.{format}

Provides tee times for a given round, including pairings and starting positions.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

⏱️
Update Frequency
This endpoint will update to a 2s TTL (time to live) upon a game moving to inprogress. Upon closed, it will transfer to 120s.

Data Points

Course

Attribute	Parent Element	Type	Description
`id`	`course`	GUID	Unique ID of a course ex. `7e9462a5-66ea-4205-b37a-81884e3653cf`
`name`	`course`	String	Name of a course ex. `Augusta National`
`par`	`course`	Integer	Par for a course ex. `72`
`yardage`	`course`	Integer	Total yardage of a course ex. `7510`

Match

Attribute	Parent Element	Type	Description
`back_nine`	`match`	Boolean	Signifies the starting point of a match (back nine or front nine)
`match_format`	`match`	String	Format of a match `singles`, `fourball`, `foursomes`
`id`	`match`	GUID	Unique ID of a match ex. `09a5bbfd-595b-4c83-b803-6f0b78679ae1`
`sequence`	`match`	Integer	Sequence number of a match within a tournament
`sequence`	`match` - `participant`	Integer	Sequence number of a player within a match
`status`	`match`	String	Status of a match ex. `inprogress`, `closed`
`title`	`match`	String	Title of a match ex. `Round 4 Match 8`
`match_type`	`match`	String	Type of a match `regular`, `semifinal`, `championship`, `consolation`
`tee_time`	`match`	dateTime	Tee time of a match ex. `2022-03-23T14:31:00+00:00`

Pairing

Attribute	Parent Element	Type	Description
`back_nine`	`pairing`	Boolean	Signifies the starting point of a pair (back nine or front nine)
`id`	`pairing`	GUID	Unique ID of a pairing ex. `01048eea-8a29-4b87-83c1-2c09557e52bb`
`tee_time`	`pairing`	dateTime	Tee time of a pairing ex. `2022-03-23T14:31:00+00:00`

Player

Attribute	Parent Element	Type	Description
`abbr_name`	`pairing` - `player`	String	Abbreviated name of a player ex. `R.McIlroy`
`amateur`	`pairing` - `player`	Boolean	Signifies that a player is in amateur status when `true`
`country`	`pairing` - `player`	String	Country of a player ex. `NORTHERN IRELAND`
`first_name`	`pairing` - `player`	String	First name of a player ex. `Rory`
`id`	`pairing` - `player`	GUID	Unique player ID ex. `da226913-b804-48de-adbf-96e956eb75ac`
`last_name`	`pairing` - `player`	String	Last name of a player ex. `McIlroy`
`name`	`pairing` - `player`	String	Name of a player ex. `McIlroy, Rory`
`seed`	`pairing` - `player`	Integer	Seed number of a player
`starting_hole`	`pairing` - `player`	Integer	Starting hole of a player within a round ex. `1` or `10`

Team

Attribute	Parent Element	Type	Description
`id`	`participant` - `team`	GUID	Unique team ID ex. `450b30b7-c73c-4164-8439-6656c89c0e58`
`name`	`participant` - `team`	String	Name of a team ex. `Europe`

Round

Attribute	Parent Element	Type	Description
`id`	`round`	GUID	Unique ID of a round ex. `56983b8a-92e6-40b1-8c53-1b38857d712b`
`number`	`round`	GUID	Number of a round
`status`	`round`	GUID	Status of a round `scheduled`, `inprogress`, `delayed`, `suspended`, `cancelled`, `complete`, `closed`, `reopened`

Tournament

Attribute	Parent Element	Type	Description
`id`	`match` - `bracket`	GUID	Unique ID of a bracket grouping ex. `64208c73-d620-426c-b0b6-88d4b6d0d499`
`name`	`match` - `bracket`	String	Name of a bracket grouping ex. `Group 11`
`course_timezone`	`tournament`	String	Timezone of a course ex. `America/New_York`
`coverage`	`tournament`	String	Coverage of a tournament. Click here for a complete breakdown of our tour coverage. ex. `full`
`end_date`	`tournament`	dateTime	End date of a tournament in local course time ex. `2022-11-20`
`event_type`	`tournament`	dateTime	Scoring type of a tournament `stroke`, `match`, `cup`, `team`, `mix`
`points`	`tournament`	Integer	Total number of FedEx Cup points for a tournament
`id`	`tournament`	GUID	Unique ID of a tournament ex. `42b7bbc2-858a-4c0d-85dc-b30179bb5e9a`
`name`	`tournament`	String	Name of a tournament ex. `Wells Fargo Championship`
`purse`	`tournament`	Float	Total prize money for a tournament ex. `15000000.0`
`currency`	`tournament`	String	Prize money currency type of a tournament ex. `USD`
`scoring_system`	`tournament`	String	Scoring system for a tournament `stroke`, `stableford`
`start_date`	`tournament`	dateTime	Start date of a tournament in local course time ex. `2022-11-20`
`status`	`tournament`	GUID	Status of a tournament `scheduled`, `inprogress`, `delayed`, `cancelled`, `created`, `complete`, `closed`, `playoff`, `reopened`
`parent_id`	`tournament`	GUID	Unique parent ID for a tournament. Use this ID to tie reoccurring events across seasons. ex. `5c8d8f92-8da7-4d5d-860b-e820d57ff640` (ID for The Masters)
`winning_share`	`tournament`	Float	Prize money for first place in a tournament ex. `1080000.0`

Path Params

access_level

string

enum

required

Defaults to trial

The access level of your API key

trial, production

Allowed:

golf_tour

string

enum

required

Defaults to pga

Golf tour

champ (PGA Tour Champions), euro (PGA European Tour), liv (LIV Golf), lpga (LPGA), oly (Olympics), pga (PGA Tour), pgad (Korn Ferry Tour), usga (USGA *2019 season only)

language_code

string

enum

required

Defaults to en

2-letter code for supported languages

da (Danish), de (German), en (English), es (Spanish), ko (Korean)

Click here for a tabular list of available languages per competition.

Allowed:

season_year

string

enum

required

Defaults to 2025

Year of the tour season

tournament_id

string

required

Defaults to 459e9ffb-1eb4-422c-9f13-1ba8344c35aa

Unique Id of a tournament, found in the Tournament Schedule endpoint

Example: 2cba1945-dc1c-4131-92f4-cfdac8c45060

round_type

string

enum

required

Defaults to rounds

Type of a round

rounds, playoff

Allowed:

round_number

string

enum

required

Defaults to 01

Number of a round

Note: The first playoff round is 01 with round_type of playoff

Allowed:

format

string

enum

required

Defaults to json

Format returned

json, xml

Allowed:

Response

Update Frequency

Data Points

200200