DMM Data And Media Service REST API
DMM provides a set of REST APIs that clients/partners can use to access NBA stat events and videos.
To use the API, please contact dmm-support@nba.com to obtain a login account and a account key.
The account key will be used to create a signature - part of request authorization header to pass to DMM. The client of REST API will send request authorization header and
application specific request parameters or xml data to DMM API.
The request authorization header consists of identifier, account login and signature.
Identifier is always "MEDIAARCHIVE"; account login is the account created for you;
signature is Base64 encoded string of the Rinjndael-128 encrypted UTF-8 data. Client application needs to use the key provided to encrypt the UTF-8 data.
UTF-8 data is the current UTC date time in the following format of "yyyy-MM-dd HH:mm:ssZ". Request authorization header sample code is available in PHP, C#, VB.NET and Java.
Upon receiving the request, DMM will decrypt the signature using the same key. If decrypted date time is older than 10 minutes, the access will be denied. If signature is valid,
API will send back the response.
The following list defines the request input and response output expected for each of the API.
The sample code links provide sample code in different programming languages.
List of Supported REST APIs
API server will be hosted at
- Production: http://dmmservice.nba.com (External) or http://dmmx2.nba-hq.com (Internal)
- Development: http://njvddmmdev01:9001
Methods:
Get a list of games on a date
| URL: |
http://njvdvsserver2.nba-hq.com/Games |
| Request Method |
GET |
Request Parameters
| Name | Type | Example | Descrption |
|---|
| Date | date | 03/01/2013 | Date should be in mm/dd/yyyy format |
| League | string | NBA, WNBA, DLeague | One of the league, optional, if not specified, it will return all games. |
For example:
http://njvdvsserver2.nba-hq.com/Games/?date=03/01/2013&league=nba
Get a list of games by date range
| URL: |
http://njvdvsserver2.nba-hq.com/GamesByRange |
| Request Method |
GET |
Request Parameters
| Name | Type | Example | Descrption |
|---|
| FromDate | date | 10/15/2015 | Date should be in mm/dd/yyyy format |
| ToDate | date | 10/18/2015 | Date should be in mm/dd/yyyy format, optional. If not specified, it will return data on FromDate |
| League | string | NBA, WNBA, DLeague | One of the league, optional, if not specified, it will return all games. |
For example:
http://njvdvsserver2.nba-hq.com/GamesByRange/?FromDate=10/15/2015&ToDate=10/18/2015&League=NBA
Get detail information, including Video links for Events of a game
| URL: |
http://njvdvsserver2.nba-hq.com/GameEvents |
| Request Method |
GET |
Request Parameters
| Name | Type | Example | Descrption |
|---|
| GameNo | string | 0021200232 | game number for the events |
| EventType | string | All, Stats, NonStats, MadeShots, AllScoredEvents | All(All events), stats(stats only), nonstats(non stat events). Default is stats. Made shots(field goals, not including freethrows). AllScoredEvents(field goals and free throws) |
| TapeAngle | string | "DF BCAST", LHH, RHH, "LO SLA" | This is optional |
| HomeAway | string | Home, Away | This is optional, get events for one of teams only |
For example:
http://njvdvsserver2.nba-hq.com/GameEvents/?GameNo=0021200233&EventType=MadeShots&HomeAway=away
This request gets all made shots excluding free throws for away team of game 0021200233.
Get Detail information, including Video links for an arbitrary list of games and events
| URL: |
http://njvdvsserver2.nba-hq.com/ListGamesEvents |
| Request Method |
POST |
Get detail information on a non-game, including video links and events
| URL: |
http://njvdvsserver2.nba-hq.com/NonGames/ |
| Request Method |
GET |
Request Parameters
| Name |
Type |
Example |
Descrption |
| RIN |
string |
0000641909 |
Is a known value to user |
For example:
http://njvdvsserver2.nba-hq.com/NonGames/?rin=0000641909
Get games for a date and its designated encoders.
| URL: |
http://njvdvsserver2.nba-hq.com/GamesEncodingSetup |
| Request Method |
GET |
Request Parameters
| Name |
Type |
Example |
Descrption |
| Date |
date |
05/02/2015 |
Game Date in mm/dd/yyyy |
For example:
http://njvdvsserver2.nba-hq.com/GamesEncodingSetup/?Date=10/19/2015
Get a list of a game's events based on preferred angles.
| URL: |
http://dmmx2.nba.com/GetGameEventsPreferredAngles |
| Request Method |
GET |
Request Parameters
| GameNo | string | 0021200232 | game number for the events |
| EventType | string | All, Stats, NonStats, MadeShots, AllScoredEvents | All(All events), stats(stats only), nonstats(non stat events). Default is stats. Made shots(field goals, not including freethrows). AllScoredEvents(field goals and free throws) |
| TapeAngle | string | "DF BCAST", LHH, RHH, "LO SLA" | Must include at least one angle |
For example:
http://dmmx2.nba-hq.com/GetGameEventsPreferredAngles/?gameno=0021700638&angles=DF BCAST&eventType=All
Gets the NBA schedule without National or Playoffs games starting from today in JSON format only
| URL: |
http://dmmx2.nba.com/NBAGamesNoNationalNoPlayoffs/ |
| Request Method |
GET |
Request Parameters
| Name | Type | Example | Descrption |
|---|
| strDate | date | 9/28/2018 | Optional date parameter. Should be empty or date in mm/dd/yyyy format |
For example:
http://dmmx2.nba-hq.com/NBAGamesNoNationalNoPlayoffs/?strDate=9/28/2018
Gets the WNBA schedule without National or Playoffs games starting from today in JSON format only
| URL: |
http://dmmx2.nba.com/WNBAGamesNoNationalNoPlayoffs/ |
| Request Method |
GET |
Request Parameters
| Name | Type | Example | Descrption |
|---|
| strDate | date | 9/7/2023 | Optional date parameter. Should be empty or date in mm/dd/yyyy format |
For example:
http://dmmx2.nba-hq.com/WNBAGamesNoNationalNoPlayoffs/?strDate=9/7/2023
Gets the NBA All Games schedule starting from selected date in JSON format only
| URL: |
http://dmmx2.nba.com/NBAAllGames/ |
| Request Method |
GET |
Request Parameters
| Name | Type | Example | Descrption |
|---|
| strDate | date | 9/28/2018 | Optional date parameter. Should be empty or date in mm/dd/yyyy format |
For example:
http://dmmx2.nba-hq.com/NBAAllGames/?strDate=9/28/2018
Gets the Blackout Team Details for a league or team
| URL: |
http://dmmx2.nba.com/Games/teamblackouts/ |
| Request Method |
GET |
Request Parameters
| Name | Type | Example | Description |
|---|
| league | string | NBA | (Optional) League - NBA, WNBA, GLeague. Default is NBA if blank. |
| team | string | knicks | (Optional) Team Name. |
For example:
http://dmmx2.nba-hq.com/Games/teamblackouts/?team=knicks
http://dmmx2.nba-hq.com/Games/teamblackouts/?league=NBA&team=knicks
http://dmmx2.nba-hq.com/Games/teamblackouts/?league=WNBA
Is the Video MP4 Available For Download?
| URL: |
http://dmmx2.nba-hq.com/Download/ReadyToDownload |
| Request Method |
GET |
Request Parameters
| Name | Type | Example | Description |
|---|
| rin | string | 0001404368 | Asset ID |
For example:
http://dmmx2.nba-hq.com/Download/ReadyToDownload?rin=0001404368
Cut Clip and Download
| URL: |
http://dmmx2.nba-hq.com/Download/ClipCut |
| Request Method |
GET |
Request Parameters
| Name | Type | Example | Description |
|---|
| rin | string | 0001404368 | (mandatory if no GAME ID supplied) Asset ID |
| gameid | string | 0022300817 | (mandatory if no RIN supplied) Game Id |
| startCutTimeSmpte | string | 13:11:26:02 | Start Cut Time (SMPTE FORMAT) |
| endCutTimeSmpte | string | 13:11:46:02 | End Cut Time (SMPTE FORMAT) |
For example:
http://dmmx2.nba-hq.com/Download/ClipCut?rin=0001404368&gameId=&startCutTimeSmpte=13:11:26:02&endCutTimeSmpte=13:11:46:02