Docs
Coverage MatrixDocumentationRelease LogLog InContact Us

Simulations

Intro

Our enhanced API simulations allow you to replay games on your own schedule.

With the replayer, you can:

  • Request a list of available recordings (by league)
  • Register a session (starting a session allows the API to be replayed back in natural time specific to the session)
  • Continually poll the endpoint for updates as one would during a live game

🗝️

Authentication

This simulation does not require an API key or any authentication


Availability

Replay simulations are currently available for the following RESTful APIs:

  • NFL
  • NCAA Football
  • MLB

Fetch Available Recordings

To see a list of available recordings the below graphQL endpoint can be used.

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

The above query is specific to the NFL ("league":"nfl"). See here for other available leagues.


Sample Responses

{
    "data": {
        "recordings": [
            {
                "id": "50d7e8f3-a1ce-4fcf-bb15-f8a2ad919e34",
                "scheduled": "2022-08-05T00:00:00.000Z",
                "meta": {
                    "gameId": "fea8d7a1-f6bb-4fc7-9875-aec8899d9db2",
                    "away_team": "f7ddd7fa-0bae-4f90-bc8e-669e4d6cf2de",
                    "home_team": "7d4fcc64-9cb5-4d1b-8e75-8a906d1e1576",
                    "scheduled": "2022-08-05T00:00:00+00:00",
                    "away_team_name": "Jacksonville Jaguars",
                    "home_team_name": "Las Vegas Raiders"
                },
                "league": "nfl",
                "start": 1659657512582,
                "end": 1659675032985,
                "title": "Hall of Fame Game (JAC at LV)",
                "apis": [
                    {
                        "name": "boxscore",
                        "description": "game box score",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "pbp",
                        "description": "game play by play",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "game",
                        "description": "game statistics",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "rosters",
                        "description": "game rosters",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    }
                ]
            },
            {
                "id": "17f90eb0-19fa-11ed-b9cf-09c7d0206b1b",
                "scheduled": "2022-08-12T23:30:00.000Z",
                "meta": {
                    "gameId": "c8101a99-619c-4e18-b163-3424732601cd",
                    "scheduled": "2022-08-12T23:30:00+00:00",
                    "away_team_name": "Arizona Cardinals",
                    "home_team_name": "Cincinnati Bengals"
                },
                "league": "nfl",
                "start": 1660347352251,
                "end": 1660363240450,
                "title": "Preseason Week 1 Jets At Bengals",
                "apis": [
                    {
                        "name": "boxscore",
                        "description": "game box score",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "pbp",
                        "description": "game play by play",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "game",
                        "description": "game statistics",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "rosters",
                        "description": "game rosters",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    }
                ]
            },
            {
                "id": "a3d1f330-19f9-11ed-9a00-4d764894a334",
                "scheduled": "2022-08-12T23:30:00.000Z",
                "meta": {
                    "gameId": "4ff3ec48-e415-4479-92f5-50204e555774",
                    "scheduled": "2022-08-12T23:30:00+00:00",
                    "away_team_name": "New York Jets",
                    "home_team_name": "Philadelphia Eagles"
                },
                "league": "nfl",
                "start": 1660347342361,
                "end": 1660360481670,
                "title": "Preseason Week 1 Jets At Eagles",
                "apis": [
                    {
                        "name": "boxscore",
                        "description": "game box score",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "pbp",
                        "description": "game play by play",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "game",
                        "description": "game statistics",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "rosters",
                        "description": "game rosters",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    }
                ]
            },
            {
                "id": "9342cb60-19fa-11ed-b9cf-09c7d0206b1b",
                "scheduled": "2022-08-13T00:30:00.000Z",
                "meta": {
                    "gameId": "d4206862-72f8-4efc-9a50-deed6c372a20",
                    "scheduled": "2022-08-13T00:30:00+00:00",
                    "away_team_name": "Green Bay Packers",
                    "home_team_name": "San Francisco 49ers"
                },
                "league": "nfl",
                "start": 1660350937916,
                "end": 1660364652698,
                "title": "Preseason Week 1 Packers At 49ers",
                "apis": [
                    {
                        "name": "boxscore",
                        "description": "game box score",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "pbp",
                        "description": "game play by play",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "game",
                        "description": "game statistics",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "rosters",
                        "description": "game rosters",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    }
                ]
            },
            {
                "id": "7eb15af0-1a58-11ed-8690-7364dba33609",
                "scheduled": "2022-08-13T17:00:00.000Z",
                "meta": {
                    "gameId": "89a14dbd-fbc3-42e6-9ae8-4d0539751456",
                    "scheduled": "2022-08-13T17:00:00+00:00",
                    "away_team_name": "Kansas City Chiefs",
                    "home_team_name": "Chicago Bears"
                },
                "league": "nfl",
                "start": 1660410318459,
                "end": 1660422995047,
                "title": "Preseason Week 1 Chiefs At Bears",
                "apis": [
                    {
                        "name": "boxscore",
                        "description": "game box score",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "pbp",
                        "description": "game play by play",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "game",
                        "description": "game statistics",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "rosters",
                        "description": "game rosters",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    }
                ]
            },
            {
                "id": "c5648d30-1a5f-11ed-91e8-116537b200a4",
                "scheduled": "2022-08-14T02:00:00.000Z",
                "meta": {
                    "gameId": "aae3af7a-31a4-47bd-9e97-03c4e289463c",
                    "scheduled": "2022-08-14T02:00:00+00:00",
                    "away_team_name": "Los Angeles Rams",
                    "home_team_name": "Los Angeles Chargers"
                },
                "league": "nfl",
                "start": 1660442772445,
                "end": 1660455197755,
                "title": "Preseason Week 1 Rams At Charger",
                "apis": [
                    {
                        "name": "boxscore",
                        "description": "game box score",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "pbp",
                        "description": "game play by play",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "game",
                        "description": "game statistics",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    },
                    {
                        "name": "rosters",
                        "description": "game rosters",
                        "formats": [
                            "json",
                            "xml"
                        ]
                    }
                ]
            }
        ]
    }
}
{
    "data": {
        "recordings": [
            {
                "id": "4c9dc160-0172-11ed-ac8d-dd2e8218595d",
                "title": "OAK At TEX",
                "meta": {
                    "gameId": "3bbab391-95a3-4941-af69-dbfb7505a68c",
                    "away_team": "27a59d3b-ff7c-48ea-b016-4798f560f5e1",
                    "home_team": "d99f919b-1534-4516-8e8a-9cd106c6d8cd",
                    "scheduled": "2022-07-12T00:05:00+00:00"
                },
                "league": "mlb",
                "scheduled": "2022-07-12T00:05:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "411247d0-0172-11ed-bd8a-ad7a06c433f1",
                "title": "ARI At SF",
                "meta": {
                    "gameId": "5fc3809b-6779-4888-8137-0d8174cbd995",
                    "away_team": "25507be1-6a68-4267-bd82-e097d94b359b",
                    "home_team": "a7723160-10b7-4277-a309-d8dd95a8ae65",
                    "scheduled": "2022-07-12T01:45:00+00:00"
                },
                "league": "mlb",
                "scheduled": "2022-07-12T01:45:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "31aa6bb0-0dd9-11ed-82ee-2f0ed1750a82",
                "title": "WAS At LAD",
                "meta": {
                    "gameId": "248692ca-bd8f-4c7a-8640-4786a83412e8",
                    "away_team": "d89bed32-3aee-4407-99e3-4103641b999a",
                    "home_team": "ef64da7f-cfaf-4300-87b0-9313386b977c",
                    "scheduled": "2022-07-27T19:10:00+00:00"
                },
                "league": "mlb",
                "scheduled": "2022-07-27T19:10:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "e43877c0-1db7-11ed-8b97-9f7f9071ee07",
                "title": "Mets at Braves (08-16-2022)",
                "meta": {
                    "gameId": "1cd428fd-e022-4d27-b355-2ba514c12f1a",
                    "away_team": "f246a5e5-afdb-479c-9aaa-c68beeda7af6",
                    "home_team": "12079497-e414-450a-8bf2-29f91de646bf",
                    "scheduled": "2022-08-16T23:20:00+00:00",
                    "away_team_name": "New York Mets",
                    "home_team_name": "Atlanta Braves"
                },
                "league": "mlb",
                "scheduled": "2022-08-16T23:20:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "9dd285a0-1e75-11ed-a06f-774a234e8833",
                "title": "Rays at Yankees (08-17-2022)",
                "meta": {
                    "gameId": "c5442820-8097-4384-b868-47bcf5cec936",
                    "away_team": "bdc11650-6f74-49c4-875e-778aeb7632d9",
                    "home_team": "a09ec676-f887-43dc-bbb3-cf4bbaee9a18",
                    "scheduled": "2022-08-17T23:05:00+00:00",
                    "away_team_name": "Tampa Bay Rays",
                    "home_team_name": "New York Yankees"
                },
                "league": "mlb",
                "scheduled": "2022-08-17T23:05:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "32965c10-1f21-11ed-b79a-5bef500da602",
                "title": "Cubs at Orioles (08-18-2022)",
                "meta": {
                    "gameId": "3288eb20-b249-43e4-a08b-25b82ee52a0d",
                    "away_team": "f246a5e5-afdb-479c-9aaa-c68beeda7af6",
                    "home_team": "12079497-e414-450a-8bf2-29f91de646bf",
                    "scheduled": "2022-08-18T19:05:00+00:00",
                    "away_team_name": "Chicago Cubs",
                    "home_team_name": "Baltimore Orioles"
                },
                "league": "mlb",
                "scheduled": "2022-08-18T19:05:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "3549cde0-5638-11ed-8b42-7798903af54b",
                "title": "World Series Game 1: PHI AT HOU",
                "meta": {
                    "gameId": "cc47a930-06a1-432f-8a46-202021b52ae6",
                    "awayTeam": "2142e1ba-3b40-445c-b8bb-f1f8b1054220",
                    "homeTeam": "eb21dadd-8f10-4095-8bf3-dfb3b779f107",
                    "scheduled": "2022-10-29T00:03:00+00:00",
                    "awayTeamName": "Phillies",
                    "homeTeamName": "Astros"
                },
                "league": "mlb",
                "scheduled": "2022-10-29T00:03:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "9b561cf0-5639-11ed-8b42-7798903af54b",
                "title": "World Series Game 3: HOU AT PHI",
                "meta": {
                    "gameId": "251cfbc0-3074-47bc-ac18-4db09299d393",
                    "awayTeam": "eb21dadd-8f10-4095-8bf3-dfb3b779f107",
                    "homeTeam": "2142e1ba-3b40-445c-b8bb-f1f8b1054220",
                    "scheduled": "2022-11-01T00:03:00+00:00",
                    "awayTeamName": "Astros",
                    "homeTeamName": "Phillies"
                },
                "league": "mlb",
                "scheduled": "2022-11-01T00:03:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "e16f67e0-563a-11ed-8b42-7798903af54b",
                "title": "World Series Game 5: HOU AT PHI",
                "meta": {
                    "gameId": "80427f15-91aa-48da-8871-ce0c20521560",
                    "awayTeam": "eb21dadd-8f10-4095-8bf3-dfb3b779f107",
                    "homeTeam": "2142e1ba-3b40-445c-b8bb-f1f8b1054220",
                    "scheduled": "2022-11-03T00:03:00+00:00",
                    "awayTeamName": "Astros",
                    "homeTeamName": "Phillies"
                },
                "league": "mlb",
                "scheduled": "2022-11-03T00:03:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "5834ade0-563b-11ed-8b42-7798903af54b",
                "title": "World Series Game 6: PHI AT HOU",
                "meta": {
                    "gameId": "be345f7c-65e5-49b1-a193-3ee5699a29dc",
                    "awayTeam": "2142e1ba-3b40-445c-b8bb-f1f8b1054220",
                    "homeTeam": "eb21dadd-8f10-4095-8bf3-dfb3b779f107",
                    "scheduled": "2022-11-05T00:03:00+00:00",
                    "awayTeamName": "Phillies",
                    "homeTeamName": "Astros"
                },
                "league": "mlb",
                "scheduled": "2022-11-06T00:03:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "881437b0-689b-11ee-ba92-d992461903f3",
                "title": "Dodgers AT Diamondbacks",
                "meta": {
                    "gameId": "2577809d-ec63-44c3-91af-69bbd7f50e16",
                    "awayTeam": "ef64da7f-cfaf-4300-87b0-9313386b977c",
                    "homeTeam": "25507be1-6a68-4267-bd82-e097d94b359b",
                    "scheduled": "2023-10-12T01:07:00+00:00",
                    "awayTeamName": "Dodgers",
                    "homeTeamName": "Diamondbacks"
                },
                "league": "mlb",
                "scheduled": "2023-10-12T01:07:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "8aac3680-6931-11ee-8885-c71784a39cb3",
                "title": "Braves AT Phillies",
                "meta": {
                    "gameId": "8603edea-a0da-4388-894a-88833ad8c965",
                    "awayTeam": 3656,
                    "homeTeam": 3635,
                    "scheduled": "2023-10-13T00:07:00+00:00",
                    "awayTeamName": "Braves",
                    "homeTeamName": "Phillies"
                },
                "league": "mlb",
                "scheduled": "2023-10-13T00:07:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "1cd08220-6949-11ee-99f9-0185b75c277a",
                "title": "Rangers AT Astros",
                "meta": {
                    "gameId": "1dad6920-4094-4959-b262-2eb835da58a3",
                    "awayTeam": 3647,
                    "homeTeam": 3655,
                    "scheduled": "2023-10-16T00:15:00+00:00",
                    "awayTeamName": "Rangers",
                    "homeTeamName": "Astros"
                },
                "league": "mlb",
                "scheduled": "2023-10-16T00:15:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "24375840-6949-11ee-99f9-0185b75c277a",
                "title": "Rangers AT Astros",
                "meta": {
                    "gameId": "a1d8b8e9-2a08-4c2a-a58d-9515f8d01085",
                    "awayTeam": 3647,
                    "homeTeam": 3655,
                    "scheduled": "2023-10-16T20:37:00+00:00",
                    "awayTeamName": "Rangers",
                    "homeTeamName": "Astros"
                },
                "league": "mlb",
                "scheduled": "2023-10-16T20:37:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "e61203a0-69c8-11ee-ad0f-83632bb2d7dc",
                "title": "Diamondbacks AT Phillies",
                "meta": {
                    "gameId": "c3f60499-2af1-48a5-8da7-20c21c0c400e",
                    "awayTeam": 3640,
                    "homeTeam": 3635,
                    "scheduled": "2023-10-18T00:07:00+00:00",
                    "awayTeamName": "Diamondbacks",
                    "homeTeamName": "Phillies"
                },
                "league": "mlb",
                "scheduled": "2023-10-18T00:07:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "f28647a0-6e8b-11ee-8e6f-03afe4a3ede9",
                "title": "Phillies AT Diamondbacks",
                "meta": {
                    "gameId": "281682d8-d030-447a-a4d8-cb9c627b6cb6",
                    "awayTeam": 3635,
                    "homeTeam": 3640,
                    "scheduled": "2023-10-19T21:07:00+00:00",
                    "awayTeamName": "Phillies",
                    "homeTeamName": "Diamondbacks"
                },
                "league": "mlb",
                "scheduled": "2023-10-19T21:07:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "f6cd6730-6e8b-11ee-8e6f-03afe4a3ede9",
                "title": "Astros AT Rangers",
                "meta": {
                    "gameId": "39cf10a7-491b-4051-8536-096fadd672c1",
                    "awayTeam": 3655,
                    "homeTeam": 3647,
                    "scheduled": "2023-10-20T00:03:00+00:00",
                    "awayTeamName": "Astros",
                    "homeTeamName": "Rangers"
                },
                "league": "mlb",
                "scheduled": "2023-10-20T00:03:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "b535aff0-6e8e-11ee-b646-af182bc02a99",
                "title": "Astros AT Rangers",
                "meta": {
                    "gameId": "695fc4be-19ee-4ed7-a02f-019896267e35",
                    "awayTeam": 3655,
                    "homeTeam": 3647,
                    "scheduled": "2023-10-20T21:07:00+00:00",
                    "awayTeamName": "Astros",
                    "homeTeamName": "Rangers"
                },
                "league": "mlb",
                "scheduled": "2023-10-20T21:07:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "b8f2b7f0-6e8e-11ee-b646-af182bc02a99",
                "title": "Phillies AT Diamondbacks",
                "meta": {
                    "gameId": "0970b182-a056-4a72-b6a3-aee784e48ede",
                    "awayTeam": 3635,
                    "homeTeam": 3640,
                    "scheduled": "2023-10-21T00:07:00+00:00",
                    "awayTeamName": "Phillies",
                    "homeTeamName": "Diamondbacks"
                },
                "league": "mlb",
                "scheduled": "2023-10-21T00:07:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "3d72e620-6f49-11ee-a5bc-8788e2e0bec3",
                "title": "Phillies AT Diamondbacks",
                "meta": {
                    "gameId": "9025f2d2-9f43-438c-ab3a-7aab03dd40d7",
                    "awayTeam": 3635,
                    "homeTeam": 3640,
                    "scheduled": "2023-10-22T00:07:00+00:00",
                    "awayTeamName": "Phillies",
                    "homeTeamName": "Diamondbacks"
                },
                "league": "mlb",
                "scheduled": "2023-10-22T00:07:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "447a1010-6f49-11ee-a5bc-8788e2e0bec3",
                "title": "Rangers AT Astros",
                "meta": {
                    "gameId": "9fa42c7a-6fed-43a3-aa7a-a61e30baaccb",
                    "awayTeam": 3647,
                    "homeTeam": 3655,
                    "scheduled": "2023-10-23T00:03:00+00:00",
                    "awayTeamName": "Rangers",
                    "homeTeamName": "Astros"
                },
                "league": "mlb",
                "scheduled": "2023-10-23T00:03:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "f6ed2540-702d-11ee-9c1f-cdc5656114f5",
                "title": "Diamondbacks AT Phillies",
                "meta": {
                    "gameId": "93b5f45e-9cd1-430d-825c-09e9474f0317",
                    "awayTeam": 3640,
                    "homeTeam": 3635,
                    "scheduled": "2023-10-23T21:07:00+00:00",
                    "awayTeamName": "Diamondbacks",
                    "homeTeamName": "Phillies"
                },
                "league": "mlb",
                "scheduled": "2023-10-23T21:07:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "235850f0-71af-11ee-9010-93ccb7adb854",
                "title": "Rangers AT Astros",
                "meta": {
                    "gameId": "75ce5b87-1cd6-4784-b2f4-7faa562ce620",
                    "awayTeam": 3647,
                    "homeTeam": 3655,
                    "scheduled": "2023-10-24T00:03:00+00:00",
                    "awayTeamName": "Rangers",
                    "homeTeamName": "Astros"
                },
                "league": "mlb",
                "scheduled": "2023-10-24T00:03:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "f9994860-7270-11ee-b77c-17678efd4ba6",
                "title": "Diamondbacks AT Phillies",
                "meta": {
                    "gameId": "505ee886-dd82-484e-8995-359e9b280895",
                    "awayTeam": 3640,
                    "homeTeam": 3635,
                    "scheduled": "2023-10-25T00:07:00+00:00",
                    "awayTeamName": "Diamondbacks",
                    "homeTeamName": "Phillies"
                },
                "league": "mlb",
                "scheduled": "2023-10-25T00:07:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "11654ae0-7346-11ee-9117-254698033706",
                "title": "Diamondbacks AT Rangers",
                "meta": {
                    "gameId": "f7fc26fe-106f-48c5-ae8e-79d6c56cf357",
                    "awayTeam": 3640,
                    "homeTeam": 3647,
                    "scheduled": "2023-10-28T00:03:00+00:00",
                    "awayTeamName": "Diamondbacks",
                    "homeTeamName": "Rangers"
                },
                "league": "mlb",
                "scheduled": "2023-10-28T00:03:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "187c5350-7346-11ee-9117-254698033706",
                "title": "Diamondbacks AT Rangers",
                "meta": {
                    "gameId": "65230957-eea6-4d4c-a284-fce1873f5b7a",
                    "awayTeam": 3640,
                    "homeTeam": 3647,
                    "scheduled": "2023-10-29T00:03:00+00:00",
                    "awayTeamName": "Diamondbacks",
                    "homeTeamName": "Rangers"
                },
                "league": "mlb",
                "scheduled": "2023-10-29T00:03:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "1f16b1b0-7346-11ee-9117-254698033706",
                "title": "Rangers AT Diamondbacks",
                "meta": {
                    "gameId": "9b6b7306-712b-408e-967b-abf02b5545bc",
                    "awayTeam": 3647,
                    "homeTeam": 3640,
                    "scheduled": "2023-10-31T00:03:00+00:00",
                    "awayTeamName": "Rangers",
                    "homeTeamName": "Diamondbacks"
                },
                "league": "mlb",
                "scheduled": "2023-10-31T00:03:00.000Z",
                "start": 0,
                "end": 0
            },
            {
                "id": "246be5e0-7346-11ee-9117-254698033706",
                "title": "Rangers AT Diamondbacks",
                "meta": {
                    "gameId": "c13cc205-a3f6-497e-84aa-9d8b289b32fe",
                    "awayTeam": 3647,
                    "homeTeam": 3640,
                    "scheduled": "2023-11-01T00:03:00+00:00",
                    "awayTeamName": "Rangers",
                    "homeTeamName": "Diamondbacks"
                },
                "league": "mlb",
                "scheduled": "2023-11-01T00:03:00.000Z",
                "start": 0,
                "end": 0
            }
        ]
    }
}

Register Your Session

Once you have selected a recording you wish to replay, you may start a session. Start a session using the id of the desired recording. At this point the specific feed - if multiple feeds are available - does not matter.

Recording Sample

{
    "id": "50d7e8f3-a1ce-4fcf-bb15-f8a2ad919e34",
    "scheduled": "2022-08-05T00:00:00.000Z",
    "meta": {
        "gameId": "fea8d7a1-f6bb-4fc7-9875-aec8899d9db2",
        "away_team": "f7ddd7fa-0bae-4f90-bc8e-669e4d6cf2de",
        "home_team": "7d4fcc64-9cb5-4d1b-8e75-8a906d1e1576",
        "scheduled": "2022-08-05T00:00:00+00:00",
        "away_team_name": "Jacksonville Jaguars",
        "home_team_name": "Las Vegas Raiders"
    },
    "league": "nfl",
    "start": 1659657512582,
    "end": 1659675032985,
    "title": "Hall of Fame Game (JAC at LV)",
    "apis": [
        {
            "name": "boxscore",
            "description": "game box score",
            "formats": [
                "json",
                "xml"
            ]
        },
        {
            "name": "pbp",
            "description": "game play by play",
            "formats": [
                "json",
                "xml"
            ]
        },
        {
            "name": "game",
            "description": "game statistics",
            "formats": [
                "json",
                "xml"
            ]
        },
        {
            "name": "rosters",
            "description": "game rosters",
            "formats": [
                "json",
                "xml"
            ]
        }
    ]
}

The above recording includes Play-By-Play (pbp), Game Boxscore (boxscore), Game Roster (rosters), and Game Statistics (game) endpoints. All are available in json or xml.


Create a Session Id

Now, take the recordingId ("id": "50d7e8f3-a1ce-4fcf-bb15-f8a2ad919e34" in the above sample) and use it to create a sessionId.

curl --location --request POST 'https://playback.sportradar.com/graphql' \
--header 'Content-Type: application/json' \
--data-raw '{"query":"mutation CreateSession($input: CreateSessionInput!) {\n    createSession(input: $input)\n }","variables":{"input":{"recordingId":"50d7e8f3-a1ce-4fcf-bb15-f8a2ad919e34"}}}'

In the above, recordingId is the id from the example response. This request will return your unique sessionId to be used in subsequent data API requests.


Session Id Sample Response

Here is a sample of a returned sessionId:

{"data":{"createSession":"60414140-53c7-11ed-bd68-ad2289887b03\_-5507944226"}}


Make an API Request

Now that you have your recordingId and sessionId you may create a RESTful API call for simulated games.

curl --location --request GET 'https://playback.sportradar.com/replay/nfl/50d7e8f3-a1ce-4fcf-bb15-f8a2ad919e34?feed=boxscore&contentType=json&sessionId=[sessionId]'

This sample is a Game Boxscore (boxscore) request for recordingId 50d7e8f3-a1ce-4fcf-bb15-f8a2ad919e34. Note that you will need to include your unique sessionid from the previous step.


To receive data updates you can now continually request this path, as you would with live game data in our RESTful APIs. See below for the complete path parameters.


RESTful Path

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

Path Parameters

ParameterDescription
leagueDesired league for the simulation.
nfl, ncaafb, mlb
recordingIdID of the recording.

(ex. 50d7e8f3-a1ce-4fcf-bb15-f8a2ad919e34)

Query String Parameters

ParameterDescription
feedDesired feed for the simulation.

boxscore, game, pbp, rosters
contentTypeDesired content type.

json or xml
sessionIdSession ID returned by the session request.

(ex. aa23f380-2234-11ed-8a8a-cbecc410da60\_-137242789)