GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

Basketball APIs - 'Start of Period' Event Type

We've added a new event_type of startperiod to our professional basketball APIs.

Leverage the startperiod entry at the beginning of each quarter/period to signify a game is in progress.


☑️ Sample Requests

Game Play-by-Play (NBA) - https://api.sportradar.com/nba/trial/v8/en/games/{game_id}/pbp.json


🔢 Versions


🔁 Endpoints Affected

  • Game Play-by-Play, Push Events

⚙️ Return Samples

{
  "id": "bdcf2e86-7d33-4a31-83e9-81c99edeae60",
  "event_type": "startperiod",
  "sequence": 1737317658500,
  "number": 2,
  "clock_fraction": 0,
  "description": "Start of 1st Quarter",
  "clock": "12:00",
  "clock_decimal": "12:00",
  "created": "2025-01-19T20:14:18Z",
  "updated": "2025-01-19T23:29:37Z",
  "wall_clock": "2025-01-19T20:14:18Z",
  "on_court":
  {
                    "home":
                    {
                        "name": "Heat",
                        "market": "Miami",
                        "reference": "1610612748",
                        "id": "583ecea6-fb46-11e1-82cb-f4ce4684ea4c",
                        "players":
                        [
                            {
                                "full_name": "Haywood Highsmith",
                                "jersey_number": "24",
                                "reference": "1629312",
                                "id": "a17d9b20-4e2b-4612-aecd-27938c997e94"
                              },
                            {
                                "full_name": "Jimmy Butler",
                                "jersey_number": "22",
                                "reference": "202710",
                                "id": "0e163d44-67a7-4107-9421-5333600166bb"
                              },
                            {
                                "full_name": "Duncan Robinson",
                                "jersey_number": "55",
                                "reference": "1629130",
                                "id": "18d35316-9f40-408c-abcc-ab49e06ef8e8"
                              },
                            {
                                "full_name": "Bam Adebayo",
                                "jersey_number": "13",
                                "reference": "1628389",
                                "id": "11c303dc-540c-4090-8e0c-76c2fb2c125a"
                              },
                            {
                                "full_name": "Tyler Herro",
                                "jersey_number": "14",
                                "reference": "1629639",
                                "id": "8bd80771-843f-4d7f-a4e7-b4d4f6c4e7c6"
                              }
                          ]
                      },
                    "away":
                    {
                        "name": "Spurs",
                        "market": "San Antonio",
                        "reference": "1610612759",
                        "id": "583ecd4f-fb46-11e1-82cb-f4ce4684ea4c",
                        "players":
                        [
                            {
                                "full_name": "Victor Wembanyama",
                                "jersey_number": "1",
                                "reference": "1641705",
                                "id": "98e2cdeb-69dc-499c-a853-84c32c714924"
                              },
                            {
                                "full_name": "Chris Paul",
                                "jersey_number": "3",
                                "reference": "101108",
                                "id": "942c53e3-7268-44e3-b0a9-fdff55a72c03"
                              },
                            {
                                "full_name": "Harrison Barnes",
                                "jersey_number": "40",
                                "reference": "203084",
                                "id": "ce8d0944-b277-499e-9701-02a5f1828615"
                              },
                            {
                                "full_name": "Devin Vassell",
                                "jersey_number": "24",
                                "reference": "1630170",
                                "id": "fe215630-2dc5-4573-95cc-c1b14abbbbcd"
                              },
                            {
                                "full_name": "Stephon Castle",
                                "jersey_number": "5",
                                "reference": "1642264",
                                "id": "ddee4a31-2791-4339-bfc3-a058ce2d1397"
                              }
                          ]
                      }
                  }
},