# Stroke Play Schedule

### Overview

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

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

### Request

**URL**

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

### Path parameters

| **Name**        | **Type** | **Required** | **Description**        |
| --------------- | -------- | ------------ | ---------------------- |
| `tournament_id` | integer  | Yes          | Tournament identifier. |

### Example request

{% code title="Get a stroke play schedule" overflow="wrap" %}

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

{% endcode %}

{% hint style="info" %}
This endpoint returns groups that are already known for the tournament. New groups can appear as the schedule is updated.
{% endhint %}

### Response example

{% code overflow="wrap" expandable="true" %}

```
{
  "groups": [
    {
      "sr_group_id": "sr:group_match:294222",
      "group_number": 10,
      "date": "2026-05-13",
      "round_number": 1,
      "starting_hole_number": 10,
      "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",
          "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"
            },
            { ... }
          ]
        },
        { ... }
      ]
    }
  ]
}
```

{% endcode %}

### Response fields

| field                                                 | type                    | description                                                                  | required | required in PGA | old IMGA API equivalent                            |
| ----------------------------------------------------- | ----------------------- | ---------------------------------------------------------------------------- | -------- | --------------- | -------------------------------------------------- |
| groups                                                | Array                   | Array of already known groups in the tournament                              | yes      |                 | array of groups was a root element of the response |
| groups\[].sr\_group\_id                               | String                  | SR ID of the group                                                           | yes      |                 | -                                                  |
| groups\[].group\_number                               | Integer                 | Group number within the round                                                | yes      |                 | groupNo                                            |
| groups\[].date                                        | Date                    | Date on which the group plays the round                                      | yes      |                 | date                                               |
| groups\[].round\_number                               | Integer                 | Round number in which the group plays                                        | yes      |                 | round                                              |
| groups\[].starting\_hole\_number                      | Integer                 | Hole number where the group starts                                           | yes      |                 | hole                                               |
| groups\[].position\_in\_sequence\_of\_groups\_on\_tee | Integer                 | Sequence of the group on the tee                                             | yes      |                 | teeSeq                                             |
| groups\[].status                                      | String                  | Status of the group. Possible values: `NOT_STARTED`, `IN_PROGRESS`, `ENDED`. | yes      |                 | status                                             |
| groups\[].start\_time                                 | Date time in UTC format | Scheduled round start time in UTC                                            | yes      |                 | startTime.time                                     |
| groups\[].teams                                       | Array                   | List of teams in the group                                                   | yes      |                 | teams                                              |
| groups\[].teams\[].team\_id                           | Integer                 | Numeric ID of the team                                                       | yes      |                 | teamNo                                             |
| groups\[].teams\[].sr\_team\_id                       | String                  | SR ID of the team                                                            | yes      |                 | -                                                  |
| groups\[].teams\[].players                            | Array                   | List of players in the team                                                  | yes      |                 | players                                            |
| groups\[].teams\[].players\[].player\_id              | Integer                 | Numeric ID of the player                                                     | yes      |                 | playerId                                           |
| groups\[].teams\[].players\[].sr\_player\_id          | String                  | SR ID of the player                                                          | yes      |                 | -                                                  |
| groups\[].teams\[].players\[].country                 | String                  | 3-character FIFA country code                                                | yes      |                 | country                                            |
| groups\[].teams\[].players\[].display\_name           | String                  | Full player name used for display                                            | yes      |                 | displayName                                        |
| groups\[].teams\[].players\[].first\_name             | String                  | First name of the player                                                     | yes      |                 | firstName                                          |
| groups\[].teams\[].players\[].last\_name              | String                  | Last name of the player                                                      | yes      |                 | lastName                                           |
| groups\[].teams\[].players\[].is\_amateur             | Boolean                 | Indicates whether the player is an amateur                                   | yes      |                 | isAmateur                                          |
| groups\[].teams\[].players\[].player\_pga\_tour\_id   | String                  | PGA Tour player identifier                                                   | no       | yes             | playerPGATourId                                    |

### Related endpoints

* [Tournaments list](/live-data/live-data-golf-api-design/ld-golf-api-documentation/ld-golf-api-endpoints-static/tournaments-list.md)
* [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)
* [Match Play Schedule](/live-data/live-data-golf-api-design/ld-golf-api-documentation/ld-golf-api-endpoints-static/match-play-schedule.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/stroke-play-schedule.md?ask=<question>
```

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.
