Integration GuidesReference Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Reference Docs

Synergy Basketball Change Log

Heave Shot Support

Release Date

Benefit

12/17/2025

We've added a boolean flag to support heave shots.

This heave attribute is present in all Possession Events and Play by Plays endpoints. When true it signifies a shot attempt is a heave.

        {
            "data": {
                "possessionId": "6940c88e1c3e0bebed0048a5",
                "game": {
                    "awayTeam": {
                        "fullName": "Detroit Pistons",
                        "conference": {
                            "name": "Eastern Conference",
                            "abbr": "EC",
                            "id": "54457dce300969b132fcfb48"
                        },
                        "division": {
                            "name": "Central Division",
                            "abbr": "CD",
                            "id": "54457dd0300969b132fcfba0"
                        },
                        "name": "Detroit",
                        "abbr": "DET",
                        "id": "54457dd3300969b132fcfe4d"
                    },
                    "competition": {
                        "name": "Regular Season excl. NBA Cup",
                        "id": "560100ac8dc7a24394b955ee"
                    },
                    "date": "2025-12-15T00:00:00Z",
                    "homeTeam": {
                        "fullName": "Boston Celtics",
                        "conference": {
                            "name": "Eastern Conference",
                            "abbr": "EC",
                            "id": "54457dce300969b132fcfb48"
                        },
                        "division": {
                            "name": "Atlantic Division",
                            "abbr": "AD",
                            "id": "54457dd0300969b132fcfb9f"
                        },
                        "name": "Boston",
                        "abbr": "BOS",
                        "id": "54457dd3300969b132fcfe3b"
                    },
                    "league": {
                        "name": "NBA",
                        "abbr": "N",
                        "id": "54457dce300969b132fcfb34"
                    },
                    "season": {
                        "name": "2025-2026",
                        "id": "68dbe5272504f23a6da2cc00"
                    },
                    "id": "68dc3ea230534aff780d9fd4"
                },
                "oPlayer": {
                    "name": "Anfernee Simons",
                    "id": "68e6fa96c30064507f31210c"
                },
                "prPlayer": {
                    "name": "Anfernee Simons",
                    "id": "68e6fa96c30064507f31210c"
                },
                "zone": false,
                "period": 4,
                "clock": 199,
                "shotClock": false,
                "homeEvent": true,
                "sob": false,
                "eob": false,
                "ato": false,
                "turnover": false,
                "possessionUpdated": "2025-12-16T04:50:50.523Z",
                "playByPlayUpdated": "2025-12-16T03:18:13.231Z",
                "offensiveString": "4 Anfernee Simons > Transition > Left Wing > Dribble Jumper > Long/3pt > Miss 3 Pts",
                "defensiveString": "Shot > Anfernee Simons > Jumper > 3 Point Attempt > Miss 3 Pts No Foul",
                "shot": "Jumper",
                "ftAttempt": 0,
                "ftMade": 0,
                "offensiveLineup": [
                    {
                        "firstName": "Jaylen",
                        "lastName": "Brown",
                        "name": "Jaylen Brown",
                        "id": "5776bc715762021398fe3f18"
                    },
                    {
                        "firstName": "Derrick",
                        "lastName": "White",
                        "name": "Derrick White",
                        "id": "6207231107c7bd5c29e1e6a8"
                    },
                    {
                        "firstName": "Neemias",
                        "lastName": "Queta",
                        "name": "Neemias Queta",
                        "id": "65234b16c0dd46415a936e1d"
                    },
                    {
                        "firstName": "Payton",
                        "lastName": "Pritchard",
                        "name": "Payton Pritchard",
                        "id": "5fd979f65fe05a0e9f63ab6b"
                    },
                    {
                        "firstName": "Anfernee",
                        "lastName": "Simons",
                        "name": "Anfernee Simons",
                        "id": "68e6fa96c30064507f31210c"
                    }
                ],
                "defensiveLineup": [
                    {
                        "firstName": "Duncan",
                        "lastName": "Robinson",
                        "name": "Duncan Robinson",
                        "id": "68e451b944d7b26aa63fe977"
                    },
                    {
                        "firstName": "Cade",
                        "lastName": "Cunningham",
                        "name": "Cade Cunningham",
                        "id": "615e4bcfe771e94fc0e9eab4"
                    },
                    {
                        "firstName": "Javonte",
                        "lastName": "Green",
                        "name": "Javonte Green",
                        "id": "68e451b944d7b26aa63fe973"
                    },
                    {
                        "firstName": "Tobias",
                        "lastName": "Harris",
                        "name": "Tobias Harris",
                        "id": "670325baff56573c7c99e0e3"
                    },
                    {
                        "firstName": "Jalen",
                        "lastName": "Duren",
                        "name": "Jalen Duren",
                        "id": "633d608040bed2399d804905"
                    }
                ],
                "external": {
                    "idsEventID": "705"
                },
                "playByPlayId": "6940c88a1c3e0bebed004727",
                "homeScore": 105,
                "awayScore": 112,
                "heave": false
            }
        },


Sportradar ID Mapping

Release Date

Benefit

11/18/2025

Synergy Basketball APIs now have SR IDs (sportradarId) included.

For example, the Teams endpoint now includes the SR IDs for each team, allowing you to connect Synergy data with Sportradar's broader ecosystem.

For some endpoints, you can even query by SR IDs directly: https://api.sportradar.com/synergy/basketball/nba/games?teamId=sr:competitor:3411

    {
      "data": {
        "id": "54457dd3300969b132fcfe4b",
        "idsTeam": 1610612741,
        "name": "Chicago",
        "fullName": "Chicago Bulls",
        "abbr": "CHI",
        "conference": {
          "name": "Eastern Conference",
          "abbr": "EC",
          "id": "54457dce300969b132fcfb48"
        },
        "division": {
          "name": "Central Division",
          "abbr": "CD",
          "id": "54457dd0300969b132fcfba0"
        },
        "league": {
          "name": "NBA",
          "abbr": "N",
          "id": "54457dce300969b132fcfb34"
        },
        "sportradarId": "sr:competitor:3409"
      }
    },


Synergy Basketball API Release

Release Date

Announcement

09/23/2025

We've launched six unique Synergy Basketball APIs. These cover the NBA, WNBA, NBA G League, NCAA D1 Men, NCAA D1 Women, and International competitions.

These APIs deliver rich, structured data on every possession of every game, including:

  • Granular metadata: play types, lineups, defensive matchups, shot coordinates, and more.
  • Career endpoints for tracking a player's journey across leagues & seasons.
  • Millions of plays and advanced metrics, helping analysts, developers, and media partners understand the game at a deeper level.