---
updatedAt: 2026-10-01T14:24:10.000Z
agentTools:
  siteIndex: https://developer.sportradar.com/llms.txt
  projectIndex: https://developer.sportradar.com/getting-started/llms.txt
---

# Simulations

## Intro

Our API simulations allow you to replay real games at any time, on your own schedule.

With the replayer, you can:

* Retrieve available game recordings (by league or sport)
* Start a simulation session for a specific game
* Poll REST endpoints to receive data as if the game were live
* Subscribe to Push feeds for real-time streaming updates

<br />

<Callout icon="🗝️" theme="default">
  ### Authentication

  Simulations do not require an API key or any authentication.
</Callout>

<br />

***

## Key Concepts

* **League**: A specific competition (e.g., NFL, MLB, NBA)
* **Sport**: A broader category, used to list soccer recordings
* **API Identifier**: The value used in request paths (`nfl`, `mlb`, `soccer`, etc.)

> Note: Most simulations are league-based. Soccer is the exception: its recordings are keyed by competition name (for example `Premier League`) rather than by a single league alias, so the sport-level query is the way to list them.

***

## Available Leagues & Sports

Replay simulations are currently available for the following APIs:

<HTMLBlock>{`
<div class="sports-coverage">
  <style>
    /* Main container - full width, no padding, with top margin */
    .sports-coverage {
      max-width: 100%;
      margin: 20px 0 0 0; /* Added 20px top margin */
      padding: 0;
      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
    }

    /* Sports grid - single column for all widths */
    .sports-grid {
      display: grid;
      grid-template-columns: 1fr; /* Single column for all widths */
      gap: 40px;
      margin: 20px 0;
      max-width: 100%; /* Full width */
    }

    /* Sport category cards - no borders */
    .sport-category {
      background: transparent;
      border: none;
      padding: 0;
      max-width: 100%;
    }

    /* Sport links grid - 6 across, full width */
    .sport-links {
      display: grid;
      grid-template-columns: repeat(6, 1fr); /* 6 equal columns */
      gap: 12px;
      justify-content: start; /* Left align */
    }

    /* Individual sport links - responsive cards with flexible width */
    .sport-links .sport-link-item {
      display: flex;
      flex-direction: column; /* Stack icon on top of text */
      align-items: center;
      justify-content: center;
      padding: 12px 8px;
      background: transparent;
      border-radius: 6px;
      text-decoration: none;
      color: #007bff;
      font-size: 14px; /* 14px font size */
      font-weight: 500;
      border: 1px solid #e9ecef;
      text-align: center;
      width: 100%; /* Full width of grid cell */
      height: 90px; /* Fixed height */
      box-sizing: border-box;
      overflow: hidden; /* Prevent any overflow */
      transition: all 0.2s ease; /* Smooth hover transition */
    }

    /* Subtle hover effect */
    .sport-links .sport-link-item:hover {
      border-color: #007bff; /* Blue border on hover */
      transform: translateY(-2px); /* Slight lift effect */
      box-shadow: 0 4px 8px rgba(0, 123, 255, 0.15); /* Subtle blue shadow */
    }

    .sport-links .sport-link-item img {
      width: 32px; /* 32px icons */
      height: 32px;
      margin-bottom: 8px;
      object-fit: contain;
      flex-shrink: 0;
    }

    /* Flexible text that adapts to parent width */
    .sport-links .sport-link-item span {
      text-align: center;
      line-height: 1.2;
      white-space: nowrap; /* Prevent wrapping */
      overflow: hidden; /* Hide overflow */
      text-overflow: ellipsis; /* Show ellipsis */
      width: 100%; /* Take full width of parent */
      max-width: 100%; /* Don't exceed parent width */
      min-width: 0; /* Allow shrinking below content width */
      display: block; /* Block element for proper width behavior */
    }

    /* Responsive breakpoints */
    @media (max-width: 1200px) {
      .sport-links {
        grid-template-columns: repeat(5, 1fr); /* 5 across on smaller screens */
      }
    }

    @media (max-width: 900px) {
      .sport-links {
        grid-template-columns: repeat(4, 1fr); /* 4 across on medium screens */
      }
    }

    @media (max-width: 600px) {
      .sport-links {
        grid-template-columns: repeat(3, 1fr); /* 3 across on mobile */
      }
    }

    @media (max-width: 400px) {
      .sport-links {
        grid-template-columns: repeat(2, 1fr); /* 2 across on very small screens */
      }
    }
  </style>

  
  <div class="sports-grid">
    
    <div class="sport-category">
      <div class="sport-links">
        <a href="https://developer.sportradar.com/football/reference/nfl-overview" class="sport-link-item">
          <img src="https://files.readme.io/76aad18-Football_american.svg" alt="NFL" />
          <span>NFL</span>
        </a>
        <a href="https://developer.sportradar.com/football/reference/ncaafb-overview" class="sport-link-item">
          <img src="https://files.readme.io/c80dc98-NCAA_National_Collegiate_Athletic_Association_college.svg" alt="NCAA Football" />
          <span>NCAAFB</span>
        </a>
        <a href="https://developer.sportradar.com/football/reference/ufl-overview" class="sport-link-item">
          <img src="https://files.readme.io/b30ec19-UFL_United_Football_League.svg" alt="UFL" />
          <span>UFL</span>
        </a>
        <a href="https://developer.sportradar.com/basketball/reference/nba-overview" class="sport-link-item">
          <img src="https://files.readme.io/27a0d50-NBA_National_Basketball_Association.svg" alt="NBA" />
          <span>NBA</span>
        </a>
        <a href="https://developer.sportradar.com/basketball/reference/wnba-overview" class="sport-link-item">
          <img src="https://files.readme.io/ab3bab6-WNBA_2019_Family_Womens_National_Basketball_Association.svg" alt="WNBA" />
          <span>WNBA</span>
        </a>
        <a href="https://developer.sportradar.com/basketball/reference/ncaamb-overview" class="sport-link-item">
          <img src="https://files.readme.io/c80dc98-NCAA_National_Collegiate_Athletic_Association_college.svg" alt="NCAA Men's Basketball" />
          <span>NCAAMB</span>
        </a>
        <a href="https://developer.sportradar.com/basketball/reference/ncaawb-overview" class="sport-link-item">
          <img src="https://files.readme.io/c80dc98-NCAA_National_Collegiate_Athletic_Association_college.svg" alt="NCAA Women's Basketball" />
          <span>NCAAWB</span>
        </a>
        <a href="https://developer.sportradar.com/basketball/reference/g-league-overview" class="sport-link-item">
          <img src="https://files.readme.io/4fb7aa7-NBA_G_League_Development_Gatorade.svg" alt="G League" />
          <span>NBA G League</span>
        </a>
        <a href="https://developer.sportradar.com/baseball/reference/mlb-overview" class="sport-link-item">
          <img src="https://files.readme.io/1736d6a-MLB_Major_League_Baseball.svg" alt="MLB" />
          <span>MLB</span>
        </a> 
				<a href="https://developer.sportradar.com/ice-hockey/docs/nhl-overview" class="sport-link-item">
          <img src="https://files.readme.io/23f10ac-NHL_National_Hockey_League.svg" alt="NHL" />
          <span>NHL</span>
        </a>
				<a href="https://developer.sportradar.com/soccer/reference/soccer-overview" class="sport-link-item">
          <img src="https://files.readme.io/1505fcb-Soccer_Football-01.svg" alt="Soccer" />
          <span>Soccer</span>
        </a>
				<a href="https://developer.sportradar.com/golf/reference/golf-overview" class="sport-link-item">
          <img src="https://files.readme.io/6941ae5-Golf.svg" alt="Golf" />
          <span>Golf</span>
        </a>
				<a href="https://developer.sportradar.com/racing/reference/nascar-overview" class="sport-link-item">
          <img src="https://files.readme.io/0bba6d9-NASCAR_2016_racing.svg" alt="NASCAR" />
          <span>NASCAR</span>
        </a>
      </div>
    </div>
  </div>
</div>
`}</HTMLBlock>

<br />

***

## Quick Start

Making a call takes four steps. Each has its own numbered section below.

1. **Fetch Available Recordings** — list what can be replayed
2. **Select a RecordingId** — pick the game or event
3. **Register Your Session** — get a `sessionId` *(REST only)*
4. **Make an API Request** — request a feed from the replay endpoint

***

## 1. Fetch Available Recordings

First, fetch the available recordings by [league](#recordings-by-league) (NFL, MLB, etc.) or by [sport](#recordings-by-sport) (soccer).

### Recordings by League

```bash
curl --location 'https://playback.sportradar.com/graphql' \
--header 'Content-Type: application/json' \
--data '{
  "query": "query getRecordings($league: String) { recordings(league: $league) { id scheduled meta league start end title apis { name description formats } } }",
  "variables": {
    "league": "nfl"
  }
}'
```

The above query is specific to the NFL (`"league":"nfl"`). Click [here](https://developer.sportradar.com/getting-started/docs/simulations#rest-path-parameters) for all available league parameters.

<div style={{display:'flex', alignItems:'center', gap:'12px', border: '1px solid #DFE2E5', padding: '8px 16px'}}><h5>Quick Access:</h5><a href="https://app.getpostman.com/run-collection/66df548787e11a120bec4021?action=collection%2Ffork&collection-url=entityId%3D66df548787e11a120bec4021%26entityType%3Dcollection%26workspaceId%3Da6193b92-ee53-4979-bbfe-7ffdc589c3fc"><img src="https://run.pstmn.io/button.svg" /></a></div>

***

### Recordings by Sport

```bash
curl --location 'https://playback.sportradar.com/graphql' \
--header 'Content-Type: application/json' \
--data '{
  "query": "query RecordingsBySport { recordingsBySport(sport: \"soccer\") { id title meta league sport scheduled start end apis { name description apiType formats versions languages } } }"
}'
```

<div style={{display:'flex', alignItems:'center', gap:'12px', border: '1px solid #DFE2E5', padding: '8px 16px'}}><h5>Quick Access:</h5><a href="https://app.getpostman.com/run-collection/66df548787e11a120bec4021?action=collection%2Ffork&collection-url=entityId%3D66df548787e11a120bec4021%26entityType%3Dcollection%26workspaceId%3Da6193b92-ee53-4979-bbfe-7ffdc589c3fc"><img src="https://run.pstmn.io/button.svg" /></a></div>

***

## 2. Select a RecordingId

Select a `RecordingId` for the game you would like to replay.

<Accordion title="NFL Response Sample" icon="fa-info-circle">
  ```json
  {
    "data": {
        "recordings": [
            {
                "id": "95aa13a0-6538-11ef-9287-d597687b4672",
                "title": "Baltimore Ravens AT Kansas City Chiefs",
                "meta": {
                    "gameId": "ebb5f3ac-bb13-4dc4-ab8b-6c65623eac13",
                    "awayTeam": "6526d38583a47c56303cf1fa",
                    "homeTeam": "6526d350fb66c7d02dfb8a0f",
                    "scheduled": "2024-09-06T00:20:00+00:00",
                    "awayTeamName": "Baltimore Ravens",
                    "homeTeamName": "Kansas City Chiefs"
                },
                "league": "nfl",
                "scheduled": "2024-09-06T00:20:00.000Z",
                "start": 1725583604260,
                "end": 1725595789187,
                "apis": [
                    {
                        "name": "events",
                        "description": "game events",
                        "apiType": "push",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "statistics",
                        "description": null,
                        "apiType": "push",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "pulse",
                        "description": "game push pulse",
                        "apiType": "push",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "boxscore",
                        "description": "game box score",
                        "apiType": "rest",
                        "formats": [
                            "json",
                            "xml"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "game",
                        "description": "game statistics",
                        "apiType": "rest",
                        "formats": [
                            "json",
                            "xml"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "pbp",
                        "description": "game play by play",
                        "apiType": "rest",
                        "formats": [
                            "json",
                            "xml"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "rosters",
                        "description": "game rosters",
                        "apiType": "rest",
                        "formats": [
                            "json",
                            "xml"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    }
                ]
            }
        ]
    }
  }
  ```
</Accordion>

<Accordion title="MLB Response Sample" icon="fa-info-circle">
  ```json
  {
    "data": {
        "recordings": [
            {
                "id": "fb821410-5fda-11ef-b731-154d1d4eafcf",
                "title": "Astros AT Phillies",
                "meta": {
                    "gameId": "9207104d-771d-4aa0-993f-7939d8b8c617",
                    "awayTeam": 3655,
                    "homeTeam": 3635,
                    "scheduled": "2024-08-27T22:40:00+00:00",
                    "awayTeamName": "Astros",
                    "homeTeamName": "Phillies"
                },
                "league": "mlb",
                "scheduled": "2024-08-27T22:40:00.000Z",
                "start": 1724798370278,
                "end": 1724807855106,
                "apis": [
                    {
                        "name": "boxscore",
                        "description": "game box score",
                        "apiType": "rest",
                        "formats": [
                            "json",
                            "xml"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "game",
                        "description": "game statistics",
                        "apiType": "rest",
                        "formats": [
                            "json",
                            "xml"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "pbp",
                        "description": "game play by play",
                        "apiType": "rest",
                        "formats": [
                            "json",
                            "xml"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "pitch metrics",
                        "description": null,
                        "apiType": "rest",
                        "formats": [
                            "json",
                            "xml"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "events",
                        "description": "game events",
                        "apiType": "push",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "statistics",
                        "description": null,
                        "apiType": "push",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "linescore",
                        "description": "game linescore",
                        "apiType": "push",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    }
                ]
            },
            {
                "id": "024fb770-5fdb-11ef-b731-154d1d4eafcf",
                "title": "Royals AT Guardians",
                "meta": {
                    "gameId": "f7d3cb9a-9cfe-40a3-8fd1-7714b0ef5654",
                    "awayTeam": 3651,
                    "homeTeam": 3650,
                    "scheduled": "2024-08-28T17:10:00+00:00",
                    "awayTeamName": "Royals",
                    "homeTeamName": "Guardians"
                },
                "league": "mlb",
                "scheduled": "2024-08-28T17:10:00.000Z",
                "start": 1724864993188,
                "end": 1724876267756,
                "apis": [
                    {
                        "name": "boxscore",
                        "description": "game box score",
                        "apiType": "rest",
                        "formats": [
                            "json",
                            "xml"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "game",
                        "description": "game statistics",
                        "apiType": "rest",
                        "formats": [
                            "json",
                            "xml"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "pbp",
                        "description": "game play by play",
                        "apiType": "rest",
                        "formats": [
                            "json",
                            "xml"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "pitch metrics",
                        "description": null,
                        "apiType": "rest",
                        "formats": [
                            "json",
                            "xml"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "events",
                        "description": "game events",
                        "apiType": "push",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "statistics",
                        "description": null,
                        "apiType": "push",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "linescore",
                        "description": "game linescore",
                        "apiType": "push",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v7"
                        ],
                        "languages": [
                            "en"
                        ]
                    }
                ]
            }
        ]
    }
  }
  ```
</Accordion>

An NFL recording may include the below RESTful endpoints. All are available in `json` or `xml`.

* **<Anchor label="Game Boxscore" target="_blank" href="https://developer.sportradar.com/football/reference/nfl-game-boxscore">Game Boxscore</Anchor>** (`boxscore`)
* **<Anchor label="Game Play-by-Play" target="_blank" href="https://developer.sportradar.com/football/reference/nfl-play-by-play">Game Play-by-Play</Anchor>** (`pbp`)
* **<Anchor label="Game Roster" target="_blank" href="https://developer.sportradar.com/football/reference/nfl-game-roster">Game Roster</Anchor>** (`rosters`)
* **<Anchor label="Game Statistics" target="_blank" href="https://developer.sportradar.com/football/reference/nfl-game-statistics">Game Statistics</Anchor>** (`game`)

It may also include Push feeds, available in `json` only:

* **<Anchor label="Push Events" target="_blank" href="https://developer.sportradar.com/football/reference/nfl-push-events">Push Events</Anchor>** (`events`)
* **<Anchor label="Push Statistics" target="_blank" href="https://developer.sportradar.com/football/reference/nfl-push-statistics">Push Statistics</Anchor>** (`statistics`)
* **<Anchor label="Push Pulse" target="_blank" href="https://developer.sportradar.com/football/reference/nfl-push-pulse">Push Pulse</Anchor>** (`pulse`)

*Available endpoints vary by league and sport*

***

## 3. Register Your Session (REST Only)

Use the `id` for your selected game to start a session. At this point the specific feed—if multiple feeds are available—is not needed.

```curl
curl --location --request POST 'https://playback.sportradar.com/graphql' \
--header 'Content-Type: application/json' \
--data-raw '{
  "query":"mutation CreateSession($input: CreateSessionInput!) { createSession(input: $input) }",
  "variables":{
    "input":{
      "recordingId":"95aa13a0-6538-11ef-9287-d597687b4672"
    }
  }
}'
```

This request uses `recordingId":"95aa13a0-6538-11ef-9287-d597687b4672` in the above NFL response sample. The response returns your unique `sessionId` to be used in subsequent data API requests.

***

## 4. Make an API Request

Use your `recordingId` and `sessionId` to make a request for a game. Continually request this path to receive updates.

Click [here](https://developer.sportradar.com/getting-started/docs/simulations#restful-request-path) for the complete path parameters.

```curl
curl --location --request GET 'https://playback.sportradar.com/replay/nfl/95aa13a0-6538-11ef-9287-d597687b4672?feed=boxscore&contentType=json&sessionId={sessionId}'
```

***

## RESTful Request Path

`https://playback.sportradar.com/replay/{sportradar_api}/{recordingId}?feed={feed}&contentType={contentType}&sessionId={sessionId}`

### REST Path Parameters

| Parameter        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sportradar_api` | Desired API (sport or league) for the simulation.<br /><br />**Baseball:**<br />`mlb` (MLB)<br /><br />**Basketball:**<br />`nba` (NBA), `nbdl` (NBA G League), `ncaamb` (NCAA Men's Basketball), `ncaawb` (NCAA Women's Basketball), `wnba` (WNBA)<br /><br />**Football:**<br />`ncaafb` (NCAA Football), `nfl` (NFL), `ufl` (UFL)<br /><br />**Golf:**<br />`pga` (PGA Tour), `lpga` (LPGA Tour)<br /><br />**Hockey:**<br />`nhl` (NHL)<br /><br />**Racing:**<br />`mc` (NASCAR Cup Series), `or` (NASCAR O'Reilly Auto Parts Series), `cw` (NASCAR Truck Series)<br /><br />**Soccer:**<br />`soccer` |
| `recordingId`    | ID of the recording.<br /><br />(ex. `95aa13a0-6538-11ef-9287-d597687b4672`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |

### RESTful Query String Parameters

| Parameter     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `feed_name`   | Desired feed for the simulation. Found under `apis.name`. Note the `apis.description` field for endpoint name if needed. *Feed availability varies for each API.*<br /><br />`boxscore`, `game`, `pbp`, `rosters`<br /><br />NHL only: `analytics`, `shot_zones`, `faceoffs`, `time_on_ice`<br /><br />Soccer only: `lineups`, `summary`, `timeline`, `standings`, `extended-timeline`, `extended-summary`, `links`, `summaries`, `season-leaders`, `season-missing-players`, `season-info`, `season-competitors`<br /><br />Golf only: `golf-summary`, `golf-leaderboard`, `golf-hole-statistics`, and per-round feeds such as `golf-scorecards-01`, `golf-teetimes-01`<br /><br />NBA Draft only: `draft-summary`, `draft-trades`, `draft-team-picks-<team_id>` (one per team)<br /><br />NASCAR only: `nascar-race-leaderboard`, `nascar-practice-leaderboard`, `nascar-qualifying-leaderboard` |
| `contentType` | Desired content type.<br /><br />`json` or `xml`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `sessionId`   | Session ID returned by the session request.<br /><br />(ex. `aa23f380-2234-11ed-8a8a-cbecc410da60\_-137242789`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `deduped`     | *Optional.* Controls replay pacing.<br /><br />Omitted or `false` — the recording replays in natural time, following its real pacing.<br /><br />`true` — duplicate and unchanged moments are stripped out and the remaining unique moments are packed back-to-back, so the recording plays back faster. Useful for multi-day events, where it removes the wait between rounds.<br /><br />*Available for recordings captured from September 2026 onward.*                                                                                                                                                                                                                                                                                                                                                                                                                                         |

***

## Push Request Path

`https://playback.sportradar.com/subscribe/{feed_name}?recording_id={recordingId}`

### Push Path Parameters

| Parameter     | Description                                                                                                                                                                                                                                                                                   |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `feed_name`   | Desired feed for the simulation. Found under `apis.name`.<br /><br />Push feeds are indicated with `"apiType": "push"`.<br /><br />`events`, `statistics`, `clock`<br /><br />`pulse` (NFL only), `linescore` (MLB only)<br /><br />Golf only: `golf-push-leaderboard`, `golf-push-scorecard` |
| `recordingId` | ID of the recording.<br /><br />(ex. `95aa13a0-6538-11ef-9287-d597687b4672`)                                                                                                                                                                                                                  |

***

## Multi-Day Events

Golf tournaments and the NBA Draft run across several days. They use the same workflow described above — fetch a recording, register a session, then request a feed — with a few differences worth knowing before you integrate.

> 📘 Skipping the wait between rounds
>
> Golf tournaments and the NBA Draft play out over several days in real life. By default a recording replays in natural time, which carries those real gaps with it — including the overnight wait between rounds. Add `deduped=true` to the replay request to pack the recording back-to-back instead, so round 2 follows round 1 rather than arriving a day later. See [Replay Pacing](#replay-pacing) below.

<br />

### Replay Pacing

A recording can be replayed at two different paces. Both use the same request path; the difference is the optional `deduped` query string parameter.

| Mode                         | Request                               | Behavior                                                                                                                                             |
| ---------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Natural time** *(default)* | `deduped` omitted, or `deduped=false` | The recording follows its real pacing, reproducing the original timing of the event — including the full gaps between rounds and between draft days. |
| **Deduped**                  | `deduped=true`                        | Duplicate and unchanged moments are stripped out and the remaining unique moments are packed back-to-back, so the recording plays back faster.       |

Natural time is the better choice when you are testing how your integration behaves over a realistic timeline. Deduped is the better choice when you want to reach the end of a multi-day event quickly, without waiting out the dead air between rounds.

> 📘 Availability
>
> The `deduped` parameter is available for recordings captured from September 2026 onward. Recordings made before then replay in natural time only — requesting `deduped=true` for one of those returns an error rather than a deduped stream.

```curl
curl --location --request GET 'https://playback.sportradar.com/replay/pga/{recordingId}?feed=golf-leaderboard&contentType=json&sessionId={sessionId}&deduped=true'
```

<br />

### Golf Simulations

Golf simulations cover the **PGA** and **LPGA** tours. Unlike other sports, golf is scoped by tour rather than by sport: pass `pga` or `lpga` as the league value on the recordings query, and use that same value as the `sportradar_api` in the replay path.

Once you have a `recordingId`, session registration and replay follow the same pattern as every other sport.

The `apis` array reflects what was captured for that specific recording rather than a fixed list. A tournament recording may include:

* `golf-summary`, `golf-leaderboard`, `golf-hole-statistics` (REST)
* `golf-push-leaderboard`, `golf-push-scorecard` (Push)

Events that carry per-round data expose one feed per round, for example `golf-scorecards-01` through `golf-scorecards-04` and `golf-teetimes-01` through `golf-teetimes-04`.

```curl
curl --location --request GET 'https://playback.sportradar.com/replay/pga/{recordingId}?feed=golf-leaderboard&contentType=json&sessionId={sessionId}'
```

<Accordion title="Golf Response Sample (LPGA)" icon="fa-info-circle">
  ```json
  {
    "id": "4b2bbce6-883e-4a1b-8cdc-f44d538dae50",
    "title": "CPKC Women's Open",
    "meta": {
      "tour": "lpga",
      "season": 2026,
      "startDate": "2026-08-20",
      "endDate": "2026-08-23",
      "tournamentId": "f70b2bf0-4702-46d6-8a07-d7d93ac9b933"
    },
    "league": "lpga",
    "sport": "golf",
    "apis": [
      { "name": "golf-push-leaderboard", "apiType": "push", "formats": ["json"] },
      { "name": "golf-push-scorecard", "apiType": "push", "formats": ["json"] },
      { "name": "golf-summary", "apiType": "rest", "versions": ["v3"], "formats": ["json"] },
      { "name": "golf-leaderboard", "apiType": "rest", "versions": ["v3"], "formats": ["json"] },
      { "name": "golf-hole-statistics", "apiType": "rest", "versions": ["v3"], "formats": ["json"] }
    ]
  }
  ```
</Accordion>

<br />

### NBA Draft Simulations

The NBA Draft is available as a simulation under the `nba` league key.

Its `apis` array has a different shape to every other simulation. Where other recordings expose a small fixed set of feed names, a draft recording exposes `draft-summary`, `draft-trades`, and **one `draft-team-picks-<team_id>` feed per team** — 30 on the current recording. Read the full list from the `apis` array in the recordings response rather than assuming a fixed set.

```curl
curl --location --request GET 'https://playback.sportradar.com/replay/nba/cc99bf90-aa6d-4802-b5a3-3c3cce2b560f?feed=draft-summary&contentType=json&sessionId={sessionId}'
```

<Accordion title="NBA Draft Response Sample" icon="fa-info-circle">
  ```json
  {
    "id": "cc99bf90-aa6d-4802-b5a3-3c3cce2b560f",
    "title": "NBA Draft 2026",
    "league": "nba",
    "scheduled": "2026-06-24T00:00:00.000Z",
    "apis": [
      { "name": "draft-summary" },
      { "name": "draft-trades" },
      { "name": "draft-team-picks-<team_id>" }
    ]
  }
  ```
</Accordion>

<br />

***

## Using Simulations to Test Failover Behavior

Sportradar provides failover coverage for leagues with official data partnerships.

You can test failover behavior for NBA or WNBA by using a simulated Top-25 NCAA men’s basketball game.