# Tournaments list ### Overview Use this endpoint to discover golf tournaments across a date range. Each tournament includes core metadata, round details, venue details, and golf course details. Use [Single Tournament](/live-data/live-data-golf-api-design/ld-golf-api-documentation/ld-golf-api-endpoints-static/single-tournament.md) when you already know the `tournament_id`. ### Request **URL** `GET https://{domain}/golf/rest/v1/tournaments` ### Query parameters | **Name** | **Type** | **Required** | **Description** | | ----------- | -------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- | | `date_from` | date | No | Return tournaments that start on or after this date. | | `date_to` | date | No | Return tournaments that start on or before this date. | | `status` | string | No | Filter by tournament status. Allowed values: `NOT_STARTED`, `IN_PROGRESS`, `INTERRUPTED`, `CANCELED`, `ENDED`, `CONFIRMED`, `MAINTENANCE`, `SUSPENDED`. | | `data_type` | string | No | Filter by tournament data type. Allowed values: `SCHEDULED`, `TEST`. | {% hint style="info" %} If you omit all query parameters, the endpoint returns tournaments that start within one month before or after the request date. {% endhint %} ### Example requests {% code title="List tournaments with default date window" overflow="wrap" %} ```http GET /golf/rest/v1/tournaments HTTP/1.1 Host: {domain} Authorization: Bearer ``` {% endcode %} {% code title="List tournaments in a date range" overflow="wrap" %} ```http GET /golf/rest/v1/tournaments?date_from=2026-05-01&date_to=2026-05-31&status=IN_PROGRESS HTTP/1.1 Host: {domain} Authorization: Bearer ``` {% endcode %} ### Response example {% code overflow="wrap" expandable="true" %} ``` { "tournaments": [ { "tour": { "sr_tour_id": "sr:stage:306287", "tour_id": 306287, "name": "PGA tour" }, "sr_tournament_id": "sr:stage:1224619", "tournament_id": 1224619, "tournament_external_id": "PGA-R2025002", "name": "Masters Tournament", "season": 2025, "status": "IN_PROGRESS", "start_date": "2025-04-10", "end_date": "2025-04-14", "start_tee_time": "2025-04-10T04:00:00Z", "country_code": "USA", "utc_offset": -4, "format": "STROKE", "endpoint_type": "STROKE", "data_type": "SCHEDULED", "rounds": [ { "round_id": 12345, "sr_round_id": "sr:stage:12345", "number": 1, "format": "STROKE", "type": "REGULAR", "status": "IN_PROGRESS", "is_playoff": false } ], "golf_courses": [ { "name": "Bethpage State Park, Black Course", "course_id": 42178, "sr_course_id": "sr:venue:42178", "external_course_id": "PGA-6", "is_main": true, "details": [ { "round_number": 1, "holes": [ { "number": 1, "actual_meters": 440.74, "actual_yardage": 482, "official_meters": 438.91, "official_yardage": 480, "par": 4, "name": "Hole 1 at Bethpage State Park, Black Course", "pin_placement": { "x": 8895.898, "y": 10520.29, "z": 18.081 }, "tee_boxes": [ { "x": 10244.591, "y": 10046.862, "z": 11.087 } ] } ] } ] } ], "venue": { "venue_id": 1234, "sr_venue_id": "sr:venue:1245", "name": "Bethpage State Park" }, "main_golf_course": { "course_id": 42178, "sr_course_id": "sr:venue:42178", "course_external_id": "PGA-6", "name": "Bethpage State Park, Black Course" } } ] } ``` {% endcode %} ### Response fields | field | type | description | required | required in PGA | old IMGA API equivalent | | --------------------------------------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | --------------- | ------------------------ | | tournaments | Array | Array of tournament objects | yes | | root | | tournaments\[].tour | Object | Information about the tour this tournament belongs to | yes | | - | | tournaments\[].tour.tour\_id | Integer | Numeric ID of the tour | yes | | tour\_id | | tournaments\[].tour.sr\_tour\_id | String | SR ID of the tour (e.g., sr:stage:1234) | yes | | - | | tournaments\[].tour.name | String | Name of the tour | yes | | tour | | tournaments\[].tournament\_id | Integer | Numeric ID of the tournament | yes | | id | | tournaments\[].sr\_tournament\_id | String | SR ID of the tournament | yes | | - | | tournaments\[].name | String | Name of the tournament | yes | | name | | tournaments\[].tournament\_external\_id | String | External federation tournament ID | no | yes | externalId | | tournaments\[].season | Integer | Year in which the tournament takes place | yes | | year | | tournaments\[].status | String |

Status of the tournament

Possible values are:

- NOT\_STARTED - IN\_PROGRESS - INTERRUPTED - CANCELED - ENDED - CONFIRMED - MAINTENANCE - SUSPENDED

| | | | | tournaments\[].start\_date | Date | Tournament start date (UTC) | yes | | startDate | | tournaments\[].end\_date | Date | Tournament end date (UTC) | yes | | endDate | | tournaments\[].start\_tee\_time | String | Tee time of the first round (UTC ISO-8601) | yes | | startTeeTime | | tournaments\[].country\_code | String | Country code (ISO alpha-3, e.g., USA) | yes | | countryCode | | tournaments\[].utc\_offset | Integer | UTC offset of tournament location (e.g., -4) | yes | | utcOffset | | tournaments\[].rounds | Array | List of tournament rounds | yes | | rounds | | tournaments\[].rounds\[].number | Integer | Round number (1–4, playoff indicated by is\_playoff) | yes | | roundNo | | tournaments\[].rounds\[].round\_id | Integer | Numeric ID of the round | yes | | - | | tournaments\[].rounds\[].sr\_round\_id | String | ID of the round in SR format | yes | | - | | tournaments\[].rounds\[].format | String |

defines the competition structure of the round, i.e. whether scoring is based on total strokes or hole-by-hole results.

Round format:

Values to be specified soon

| yes | | roundType | | tournaments\[].rounds\[].type | String |

defines how the round is played in practice, including whether players compete individually or in teams and how shots are taken.

Round type:

Values to be specified soon

| yes | | format | | tournaments\[].rounds\[].status | String |

Status of the round

Possible values are:

- NOT\_STARTED - GROUPINGS - IN\_PROGRESS - INTERRUPTED - CANCELED - ENDED - CONFIRMED - MAINTENANCE - SUSPENDED

| yes | | - | | tournaments\[].rounds\[].is\_playoff | Boolean | Indicates if round is a playoff | yes | | isPlayoff | | tournaments\[].golf\_courses | Array | Golf courses used in the tournament | yes | | golfCourses | | tournaments\[].golf\_courses\[].course\_id | Integer | Numeric course ID | yes | | courseId | | tournaments\[].golf\_courses\[].sr\_course\_id | String | SR ID of the course | yes | | - | | tournaments\[].golf\_courses\[].name | String | Name of the golf course | yes | | courseName | | tournaments\[].golf\_courses\[].external\_course\_id | String | External course ID | no | yes | externalCourseId | | tournaments\[].golf\_courses\[].is\_main | Boolean | Indicates if this is the main course | yes | | isMain | | tournaments\[].golf\_courses\[].details | Array | Course details per round | yes | | courseDetails | | tournaments\[].golf\_courses\[].details\[].round\_number | Integer | Round number for which details apply | yes | | roundNo | | tournaments\[].golf\_courses\[].details\[].holes | Array | List of holes | yes | | holes | | tournaments\[].golf\_courses\[].details\[].holes\[].number | Integer | Hole number | yes | | holeNo | | tournaments\[].golf\_courses\[].details\[].holes\[].actual\_meters | Decimal | Actual playing distance (meters) | yes | | actualMetres | | tournaments\[].golf\_courses\[].details\[].holes\[].actual\_yardage | Integer | Actual playing distance (yards) | yes | | actualYardage | | tournaments\[].golf\_courses\[].details\[].holes\[].official\_meters | Decimal | Official course distance (meters) | yes | | officialMetres | | tournaments\[].golf\_courses\[].details\[].holes\[].official\_yardage | Integer | Official course distance (yards) | yes | | officialYardage | | tournaments\[].golf\_courses\[].details\[].holes\[].par | Integer | Par value of the hole | yes | | par | | tournaments\[].golf\_courses\[].details\[].holes\[].name | String | Display name of the hole | yes | | displayName | | tournaments\[].golf\_courses\[].details\[].holes\[].pin\_placement | Object | Pin coordinates | yes | | pinPlacement | | tournaments\[].golf\_courses\[].details\[].holes\[].pin\_placement.x | Decimal | X coordinate | yes | | x | | tournaments\[].golf\_courses\[].details\[].holes\[].pin\_placement.y | Decimal | Y coordinate | yes | | y | | tournaments\[].golf\_courses\[].details\[].holes\[].pin\_placement.z | Decimal | Z coordinate | yes | | z | | tournaments\[].golf\_courses\[].details\[].holes\[].tee\_boxes | Array | Tee boxes used for the hole | yes | | teeBoxes | | tournaments\[].golf\_courses\[].details\[].holes\[].tee\_boxes\[].x | Decimal | X coordinate | yes | | x | | tournaments\[].golf\_courses\[].details\[].holes\[].tee\_boxes\[].y | Decimal | Y coordinate | yes | | y | | tournaments\[].golf\_courses\[].details\[].holes\[].tee\_boxes\[].z | Decimal | Z coordinate | yes | | z | | tournaments\[].venue | Object | Venue information | yes | | venue | | tournaments\[].venue.venue\_id | Integer | Numeric venue ID | yes | | - | | tournaments\[].venue.sr\_venue\_id | String | SR venue ID | yes | | - | | tournaments\[].venue.name | String | Venue name | yes | | venue | | tournaments\[].main\_golf\_course | Object | Main course reference. This duplicates the course marked with `is_main` in `golf_courses[]`. | yes | | - | | tournaments\[].main\_golf\_course.course\_id | Integer | Main course ID | yes | | mainGolfCourseId | | tournaments\[].main\_golf\_course.sr\_course\_id | String | SR ID of main course | yes | | - | | tournaments\[].main\_golf\_course.course\_external\_id | String | External ID of main course | yes | | mainExternalGolfCourseId | | tournaments\[].main\_golf\_course.name | String | Name of the main golf course | | | - | | tournaments\[].format | String |

Tournament format

- STROKE - single players stroke play - TEAM - team stroke play - CUP - match plays with squads - MATCH - match play of single players

| yes | | format | | tournaments\[].endpoint\_type | String |

Information which endpoint types should be connected for getting schedule, leaderboard, hole-by-hole and events

- STROKE - MATCH

| yes | | - | | tournaments\[].data\_type | String |

Data type of the tournament

- SCHEDULED - TEST

| yes | | tournamentDataStatus | ### Related endpoints * [Single Tournament](/live-data/live-data-golf-api-design/ld-golf-api-documentation/ld-golf-api-endpoints-static/single-tournament.md) * [Entrylist](/live-data/live-data-golf-api-design/ld-golf-api-documentation/ld-golf-api-endpoints-static/entrylist.md) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.sportradar.com/live-data/live-data-golf-api-design/ld-golf-api-documentation/ld-golf-api-endpoints-static/tournaments-list.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.