GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

API Simulations – Golf & NBA Draft Coverage

We've added replay simulation coverage for Golf tournaments and the NBA Draft in our API Simulations tool.

Golf and the NBA Draft both play out across multiple days, so the Simulations page now includes a Multi-Day Events section explaining how they differ from single-game replays.


⭐ Benefit

Build and test Golf and NBA Draft integrations on demand, without waiting for a live tournament or the once-a-year draft — including realistic exercise of tournament and round status transitions that only occur during live play.


📋 Recommended Actions

  • Golf customers: use pga or lpga as the league value on both the recordings query and the replay path — there is no golf key. A request built by copying the pattern from another sport (e.g. nfl, mlb) will fail.
  • NBA Draft customers: read the feed list from the apis array on the recording response. Draft recordings expose draft-summary, draft-trades, and one draft-team-picks-<team_id> feed per team (30 on the current recording) — not a fixed feed set. Hardcoding from another sport's example will miss almost all of the draft data.
  • For all multi-day events, treat the apis array as recording-specific rather than assuming a fixed list — golf tournaments with per-round data expose one feed per round (e.g. golf-scorecards-01 through -04).
  • Multi-day replays run in natural time by default, carrying the full overnight gaps between rounds and draft days. To pack the recording back-to-back instead, add deduped=true to your replay request. Available for recordings captured from September 2026 onward — earlier recordings replay in natural time only, and passing deduped=true to one returns an error.
  • Golf customers testing status handling: use Simulations to exercise the scheduled → inprogress → closed → playoff transitions on demand, rather than waiting for a live tournament.

☑️ Sample Requests:

Fetch Golf recordings (PGA)

curl --request GET \
     --url 'https://playback.sportradar.com/replay/pga/recordings' \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

Fetch NBA Draft recordings

curl --request GET \
     --url 'https://playback.sportradar.com/replay/nba/recordings' \
     --header 'accept: application/json' \
     --header 'x-api-key: YOUR_API_KEY'

🔢 Products

SportProductVersion(s)
GolfGolf APIv3
BasketballNBA APIv8

⚙️ Return Samples

{
    "data": {
        "recordings": [
            {
                "id": "4f4db56f-6c11-4b69-88de-10f9f71c424e",
                "title": "FedEx St. Jude Championship",
                "meta": {
                    "tour": "pga",
                    "season": 2026,
                    "endDate": "2026-08-16",
                    "startDate": "2026-08-13",
                    "totalRounds": 4,
                    "tournamentId": "731ff85c-d47f-4370-9b73-9ed7d9483737"
                },
                "league": "pga",
                "scheduled": "2026-08-13T00:00:00.000Z",
                "start": 1786717842898,
                "end": 1786916860054,
                "apis": [
                    {
                        "name": "golf-summary",
                        "description": "",
                        "apiType": "rest",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v3"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "golf-leaderboard",
                        "description": "",
                        "apiType": "rest",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v3"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "golf-hole-statistics",
                        "description": "",
                        "apiType": "rest",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v3"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "golf-scorecards-01",
                        "description": "",
                        "apiType": "rest",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v3"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "golf-scorecards-02",
                        "description": "",
                        "apiType": "rest",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v3"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "golf-scorecards-03",
                        "description": "",
                        "apiType": "rest",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v3"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "golf-scorecards-04",
                        "description": "",
                        "apiType": "rest",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v3"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "golf-teetimes-01",
                        "description": "",
                        "apiType": "rest",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v3"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "golf-teetimes-02",
                        "description": "",
                        "apiType": "rest",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v3"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "golf-teetimes-03",
                        "description": "",
                        "apiType": "rest",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v3"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "golf-teetimes-04",
                        "description": "",
                        "apiType": "rest",
                        "formats": [
                            "json"
                        ],
                        "versions": [
                            "v3"
                        ],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "golf-push-leaderboard",
                        "description": "",
                        "apiType": "push",
                        "formats": [
                            "json"
                        ],
                        "versions": [],
                        "languages": [
                            "en"
                        ]
                    },
                    {
                        "name": "golf-push-scorecard",
                        "description": "",
                        "apiType": "push",
                        "formats": [
                            "json"
                        ],
                        "versions": [],
                        "languages": [
                            "en"
                        ]
                    }
                ]
            },
{
    "recordings": [
        {
            "id": "...",
            "sportradar_api": "nba",
            "name": "NBA Draft 2026",
            "start_time": "...",
            "end_time": "...",
            "apis": [
                "draft-summary",
                "draft-trades",
                "draft-team-picks-583ecae2-fb46-11e1-82cb-f4ce4684ea4c",
                "draft-team-picks-583ec773-fb46-11e1-82cb-f4ce4684ea4c",
                "draft-team-picks-583ec87d-fb46-11e1-82cb-f4ce4684ea4c"
            ]
            // ...one draft-team-picks-<team_id> feed per team, 30 on the current recording
        }
    ]
}