> For the complete documentation index, see [llms.txt](https://docs.sportradar.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sportradar.com/live-data/live-data-golf-api-design/ld-golf-api-documentation/state-leaderboard-scoreboard-hole-by-hole/stroke-play-leaderboard.md).

# Stroke Play Leaderboard

### Overview

Use this resource to retrieve the current stroke play leaderboard.

It includes total standings and round-level results.

* **REST:** `GET https://{domain}/golf/rest/v1/tournaments/{tournament_id}/stroke-play-leaderboard`
* **WebSocket:** `wss://{domain}/golf/stream/v1/tournaments/{tournament_id}/stroke-play-leaderboard`

### Path parameters

* `tournament_id`
  * type: integer
  * Tournament identifier.
  * example: `12345`

{% hint style="info" %}
REST returns the payload below.

WebSocket wraps the same payload in the state envelope described in [State (leaderboard, scoreboard, hole-by-hole)](/live-data/live-data-golf-api-design/ld-golf-api-documentation/state-leaderboard-scoreboard-hole-by-hole.md).
{% endhint %}

### Response example

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

```json
{
  "tournament_id": 294222,
  "sr_tournament_id": "sr:stage:294222",
  "timestamp": "2026-04-17T12:00:00Z",
  "tournament_status": "IN_PROGRESS",
  "round_statuses": [
    {
      "round_number": 1,
      "status": "COMPLETED"
    },
    {
      "round_number": 2,
      "status": "COMPLETED"
    },
    {
      "round_number": 3,
      "status": "IN_PROGRESS"
    }
  ],
  "team_standings": [
    {
      "team_id": 3,
      "sr_team_id": "sr:competitor:3",
      "players": [
        {
          "player_id": 1,
          "sr_player_id": "sr:competitor:1",
          "first_name": "John",
          "last_name": "Doe",
          "display_name": "John Doe",
          "country": "USA",
          "is_amateur": false
        },
        {
          ...
        }
      ],
      "current_round_number": 4,
      "holes_through": 18,
      "position": {
        "value": 1,
        "order": 1,
        "position_format": "absolute"
      },
      "total_score": 80,
      "to_par_total": -5,
      "to_par_today": -1,
      "rounds_info": {
        "1": {
          "score": 5,
          "to_par": -1,
          "tee_time": "2026-04-16T10:00:00Z",
          "starting_hole_number": 10,
          "round_finish_position": 1,
          "round_finish_is_tied": false
        },
        "2": {
          ...
        },
        "3": {
          ...
        },
        "4": {
          ...
        }
      }
    }
  ],
  "current_round": {
    "round_number": 4,
    "round_name": "Round 4",
    "cut_line": {
      "cut": 6,
      "required": true
    }
  }
}
```

{% endcode %}

### Field details

| **name**                                                        | **type**                   | **description**                                                                              | **required** | **required in PGA** | **old IMGA API equivalent**                                        |
| --------------------------------------------------------------- | -------------------------- | -------------------------------------------------------------------------------------------- | ------------ | ------------------- | ------------------------------------------------------------------ |
| tournament\_id                                                  | integer                    | Numeric tournament identifier.                                                               | yes          |                     | tournamentId                                                       |
| sr\_tournament\_id                                              | string                     | tournament id in SR format                                                                   | yes          |                     | -                                                                  |
| timestamp                                                       | datetime (ISO 8601 string) | timestamp indicating when the data snapshot was generated                                    | yes          |                     | timestamp                                                          |
| tournament\_status                                              | string                     | Overall tournament status.                                                                   | yes          |                     | tournamentStatus                                                   |
| round\_statuses                                                 | array                      | list of round status objects                                                                 | yes          |                     | roundStatuses                                                      |
| round\_statuses\[].round\_number                                | integer                    | round number                                                                                 | yes          |                     | roundStatuses\[].number                                            |
| round\_statuses\[].status                                       | string                     | Status of the specific round.                                                                | yes          |                     | roundStatuses\[].status                                            |
| team\_standings                                                 | array                      | list of teams and their standings                                                            | yes          |                     | standings                                                          |
| team\_standings\[].team\_id                                     | integer                    | numeric id of the team                                                                       | yes          |                     | standings\[].                                                      |
| team\_standings\[].sr\_team\_id                                 | string                     | team id in SR format                                                                         | yes          |                     | -                                                                  |
| team\_standings\[].players                                      | array                      | list of players in the team                                                                  | yes          |                     | standings\[].players                                               |
| team\_standings\[].players\[].player\_id                        | integer                    | numeric id of the player                                                                     | yes          |                     | standings\[].players\[].id                                         |
| team\_standings\[].players\[].sr\_player\_id                    | string                     | player id in SR format                                                                       | yes          |                     | -                                                                  |
| team\_standings\[].players\[].first\_name                       | string                     | player's first name                                                                          | yes          |                     | standings\[].players\[].firstName                                  |
| team\_standings\[].players\[].last\_name                        | string                     | player's last name                                                                           | yes          |                     | standings\[].players\[].lastName                                   |
| team\_standings\[].players\[].display\_name                     | string                     | player’s full display name                                                                   | yes          |                     | standings\[].players\[].                                           |
| team\_standings\[].players\[].country                           | string                     | player's country                                                                             | yes          |                     | standings\[].players\[].                                           |
| team\_standings\[].players\[].is\_amateur                       | boolean                    | indicates whether the player is an amateur                                                   | yes          |                     | standings\[].players\[].                                           |
| team\_standings\[].current\_round\_number                       | integer                    | the current round the team is playing                                                        | yes          |                     | standings\[].currentRound                                          |
| team\_standings\[].holes\_through                               | integer                    | number of holes completed in the current round                                               | yes          |                     | standings\[].holesThrough                                          |
| team\_standings\[].position                                     | object                     | object containing ranking details                                                            | yes          |                     | standings\[].position                                              |
| team\_standings\[].position.value                               | integer                    | current position of the team                                                                 | yes          |                     | standings\[].position.value                                        |
| team\_standings\[].position.order                               | integer                    | Ordering value for ranking display                                                           | yes          |                     | standings\[].position.order                                        |
| team\_standings\[].position.position\_format                    | string                     | Either `absolute` if only one team holds the position, or `tied` if multiple teams share it. | yes          |                     | standings\[].position.format                                       |
| team\_standings\[].total\_score                                 | integer                    | total accumulated score                                                                      | yes          |                     | standings\[].totalScore                                            |
| team\_standings\[].to\_par\_total                               | integer                    | total score relative to par                                                                  | yes          |                     | standings\[].toPar.value                                           |
| team\_standings\[].to\_par\_today                               | integer                    | score relative to par for the current day                                                    | yes          |                     | standings\[].toParToday                                            |
| team\_standings\[].rounds\_info                                 | object (map)               | per-round performance keyed by round number (e.g., "1", "2")                                 | yes          |                     | standings\[].roundInfo                                             |
| team\_standings\[].rounds\_info.{round}.score                   | integer                    | score in the round                                                                           | yes          |                     | standings\[].roundInfo.{round}.score                               |
| team\_standings\[].rounds\_info.{round}.to\_par                 | integer                    | score relative to par in the round                                                           | yes          |                     | standings\[].roundInfo.{round}.toPar                               |
| team\_standings\[].rounds\_info.{round}.tee\_time               | datetime (ISO 8601 string) | start time for the round                                                                     | yes          |                     | standings\[]..roundInfo.{round}.tee\_time                          |
| team\_standings\[].rounds\_info.{round}.starting\_hole\_number  | integer                    | hole number where the player/team started                                                    | yes          |                     | standings\[]..roundInfo.{round}.startHole                          |
| team\_standings\[].rounds\_info.{round}.round\_finish\_position | integer                    | Position achieved in that round                                                              | yes          |                     | standings\[].standings\[]..roundInfo.{round}.roundFinishedPosition |
| team\_standings\[].rounds\_info.{round}.round\_finish\_is\_tied | boolean                    | Indicates if the finish position was tied                                                    | yes          |                     | standings\[].standings\[]..roundInfo.{round}.roundFinishedIsTied   |
| current\_round                                                  | object                     | Information about the currently active round                                                 | yes          |                     | currentRound                                                       |
| current\_round.round\_number                                    | integer                    | Current round number                                                                         | yes          |                     | currentRound.number                                                |
| current\_round.round\_name                                      | integer/string             | Name or identifier of the round                                                              | yes          |                     | currentRound.name                                                  |
| current\_round.cut\_line                                        | object                     | Cut line details                                                                             | yes          |                     | currentRound.cutline                                               |
| current\_round.cut\_line.cut                                    | integer                    | Cut threshold value                                                                          | yes          |                     | currentRound.cut\_line\_cut                                        |
| current\_round.cut\_line.required                               | boolean                    | Indicates whether the cut is enforced and should be displayed                                | yes          |                     | currentRound.cut\_line\_cut                                        |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/state-leaderboard-scoreboard-hole-by-hole/stroke-play-leaderboard.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.
