SportsDataIO

https://sportsdata.io/developers/
Admin
SportsDataIO is a comprehensive sports data API platform providing real-time scores, stats, odds,...
Tokens:1,037,663
Snippets:3,549
Trust Score:5.4
Update:8 months ago
Show doc for...
Tokens:
Raw
### GET /playergame/basic

Source: https://sportsdata.io/developers/workflow-guide/soccer

Retrieves projected and confirmed starting lineups and substitute benches for a given competition on a specific date.

```APIDOC
## GET /playergame/basic

### Description
Retrieves projected and confirmed starting XIs and substitute benches for a given competition on a given date.

### Method
GET

### Endpoint
`/playergame/basic`

### Query Parameters
- **competitionId** (integer) - Required - The ID of the competition.
- **date** (string) - Required - The date in 'YYYY-MM-DD' format.

### Response
#### Success Response (200)
- **PlayerGameBasic[]** (array) - An array of player game basic information.

#### Response Example
```json
[
  {
    "player": {
      "playerId": 123,
      "name": "John Doe",
      "teamId": 45,
      "teamName": "Team A"
    },
    "status": "starter",
    "position": "Forward"
  }
]
```
```

--------------------------------

### GET /v3/nba/projections/json/StartingLineupsByDate/{date}

Source: https://sportsdata.io/developers/api-documentation/nba

Retrieves projected and confirmed starting lineups for a specified date. This endpoint is useful for getting the most up-to-date lineup information before games begin.

```APIDOC
## GET /v3/nba/projections/json/StartingLineupsByDate/{date}

### Description
Returns projected and confirmed starting lineups for the specified date.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/nba/projections/json/StartingLineupsByDate/{date}

### Parameters
#### Path Parameters
- **date** (string) - Required - The date of the game(s). Examples: `2021-OCT-12`, `2021-DEC-09`.

#### Query Parameters
- **key** (string) - Required - Your unique API key for subscription.
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.

### Request Example
```json
{
  "example": "https://api.sportsdata.io/v3/nba/projections/json/StartingLineupsByDate/2023-OCT-26?key=YOUR_API_KEY"
}
```

### Response
#### Success Response (200)
- **Lineup** (array) - An array of lineup information.
- **StartingLineups** (array) - An array of starting lineup details.

#### Response Example
```json
{
  "example": "[StartingLineups[]]"
}
```
```

--------------------------------

### GET /StartingLineups/{date}

Source: https://sportsdata.io/developers/api-documentation/nba

Retrieves projected and confirmed starting lineups for a specified date. Requires a valid API key.

```APIDOC
## GET /StartingLineups/{date}

### Description
Returns projected and confirmed starting lineups for the specified date.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/nba/stats/json/StartingLineups/{date}

### Parameters
#### Query Parameters
- **key** (string) - Required - Your subscription API key.

#### Path Parameters
- **date** (string) - Required - The date for which to retrieve starting lineups (format YYYY-MM-DD).
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.

### Request Example
```json
{
  "example": "https://api.sportsdata.io/v3/nba/stats/json/StartingLineups/2023-10-26?key=YOUR_API_KEY"
}
```

### Response
#### Success Response (200)
- **LineupStartingLineups[]** - An array of starting lineup objects.

#### Response Example
```json
{
  "example": "[LineupStartingLineups objects]"
}
```
```

--------------------------------

### GET Lineups - by Date

Source: https://sportsdata.io/developers/coverages/soccer

Retrieves projected and confirmed starting lineups and substitute benches for a given competition on a specific date.

```APIDOC
## GET Lineups - by Date

### Description
Projected and confirmed starting XIs and substitute benches for a given competition on a given date.

### Method
GET

### Endpoint
`/lineups/date/{date}`

### Parameters
#### Path Parameters
- **date** (string) - Required - The date in YYYY-MM-DD format.
#### Query Parameters
- **competitionId** (string) - Optional - The identifier for the competition.

### Response
#### Success Response (200)
- **PlayerGameBasic[]** (array) - An array of player lineup data.

#### Response Example
```json
[
  {
    "gameId": "12345",
    "teamId": "teamA",
    "lineup": {
      "formation": "4-4-2",
      "startingXI": ["player1", "player2"],
      "substitutes": ["player3"]
    }
  }
]
```
```

--------------------------------

### GET /v3/mlb/projections/json/StartingLineupsByDate/{date}

Source: https://sportsdata.io/developers/api-documentation/mlb

Retrieves projected and confirmed starting lineups for games scheduled on a specific date. This is crucial for fantasy sports and betting.

```APIDOC
## GET /v3/mlb/projections/json/StartingLineupsByDate/{date}

### Description
Returns projected and confirmed starting lineups for games on the specified date.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/mlb/projections/json/StartingLineupsByDate/{date}

### Parameters
#### Path Parameters
- **date** (string) - Required - The date of the slates. Examples: `2017-JUL-31`, `2017-SEP-01`.

#### Query Parameters
- **key** (string) - Required - Your subscription key.
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.
```

--------------------------------

### Get NFL Standings - XML Example

Source: https://sportsdata.io/developers/api-documentation/nfl

Example of an HTTP GET request to retrieve regular season standings for NFL teams in a specified season. The response is returned in XML format.

```HTTP
GET https://api.sportsdata.io/v3/nfl/scores/xml/Standings/**{season}**
```

--------------------------------

### Get NFL Standings - JSON Example

Source: https://sportsdata.io/developers/api-documentation/nfl

Example of an HTTP GET request to retrieve regular season standings for NFL teams in a specified season. The response is returned in JSON format.

```HTTP
GET https://api.sportsdata.io/v3/nfl/scores/json/Standings/**{season}**
```

--------------------------------

### GET /v3/mlb/projections/json/DfsSlatesByDate/{date}

Source: https://sportsdata.io/developers/api-documentation/mlb

Returns DFS Slates which have not yet started for which we have DFS projections.

```APIDOC
## GET /v3/mlb/projections/json/DfsSlatesByDate/{date}

### Description
Returns DFS Slates which have not yet started for which we have DFS projections.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/mlb/projections/json/DfsSlatesByDate/{date}

### Parameters
#### Query Parameters
- **key** (string) - Required - Your unique subscription key.
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.

#### Path Parameters
- **date** (string) - Required - The date of the slates. Examples: `2017-JUL-31`, `2017-SEP-01`.

### Response
#### Success Response (200)
- **DfsSlate[]** - An array of DfsSlate objects.

#### Response Example
```json
[
  {
    "SlateID": 12345,
    "SlateName": "Main Slate",
    "Operator": "DraftKings",
    "OperatorDayId": "2023-10-27",
    "GameCount": 10,
    "StartTime": "2023-10-27T18:00:00Z",
    "EndTime": "2023-10-27T23:00:00Z"
  }
]
```
```

--------------------------------

### GET /CurrentSeason

Source: https://sportsdata.io/developers/api-documentation/golf

Retrieves the current golf season's calendar year, including its start and end dates.

```APIDOC
## GET /CurrentSeason

### Description
Returns the calendar year of the current season with the start and end date.

### Method
GET

### Endpoint
https://api.sportsdata.io/golf/v2/json/CurrentSeason

### Parameters
#### Query Parameters
- **key** (string) - Required - Your unique API subscription key.
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.

### Response
#### Success Response (200)
- **Season** (object) - An object containing the current season's year, start date, and end date.

#### Response Example
```json
{
  "SeasonYear": 2024,
  "StartDate": "2024-01-01T00:00:00",
  "EndDate": "2024-12-31T23:59:59"
}
```
```

--------------------------------

### Starting Lineups by Date

Source: https://sportsdata.io/developers/data-dictionary/nba

Retrieve starting lineups for games on a specific date, including team IDs, game status, and player lineups.

```APIDOC
## GET /lineups/starting

### Description
Retrieves the starting lineups for games on a specified date.

### Method
GET

### Endpoint
/lineups/starting

### Parameters
#### Query Parameters
- **Date** (datetime) - Required - The day of the game
- **GameID** (integer) - Optional - The unique ID of the game associated with this lineup
- **Season** (integer) - Optional - The NBA season of the game that the lineups is associated with
- **SeasonType** (integer) - Optional - The type of season that this record corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar; 6=Exhibition)
- **DateTime** (datetime) - Optional - Date and Time of Game
- **Status** (string) - Optional - Indicates the game's status. Possible values include: Scheduled; InProgress; Final; F/OT; Suspended; Postponed; Delayed; Canceled; Forfeit
- **HomeTeamID** (integer) - Optional - The unique ID of the home team
- **HomeTeam** (string) - Optional - The abbreviation [Key] of the home team
- **AwayTeamID** (integer) - Optional - Unique ID of Away Team
- **AwayTeam** (string) - Optional - The abbreviation [Key] of the away team

### Response
#### Success Response (200)
- **GameID** (integer) - The unique ID of the game associated with this lineup
- **Season** (integer) - The NBA season of the game that the lineups is associated with
- **SeasonType** (integer) - The type of season that this record corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar; 6=Exhibition)
- **Day** (datetime) - The day of the game
- **DateTime** (datetime) - Date and Time of Game
- **Status** (string) - Indicates the game's status.
- **HomeTeamID** (integer) - The unique ID of the home team
- **HomeTeam** (string) - The abbreviation [Key] of the home team
- **AwayTeamID** (integer) - Unique ID of Away Team
- **AwayTeam** (string) - The abbreviation [Key] of the away team
- **HomeLineup** (Lineup[]) - The lineup (starters and bench players) of the home team in a given game
- **AwayLineup** (Lineup[]) - The lineup (starters and bench players) of the away team in a given game

#### Response Example
```json
{
  "GameID": 78901,
  "Season": 2023,
  "SeasonType": 1,
  "Day": "2023-10-24T00:00:00",
  "DateTime": "2023-10-24T19:00:00",
  "Status": "Scheduled",
  "HomeTeamID": 101,
  "HomeTeam": "LAL",
  "AwayTeamID": 102,
  "AwayTeam": "BOS",
  "HomeLineup": [
    {
      "PlayerID": 1111,
      "Name": "LeBron James",
      "Position": "SF",
      "Started": true
    },
    {
      "PlayerID": 2222,
      "Name": "Anthony Davis",
      "Position": "PF",
      "Started": true
    }
  ],
  "AwayLineup": [
    {
      "PlayerID": 3333,
      "Name": "Jayson Tatum",
      "Position": "SF",
      "Started": true
    },
    {
      "PlayerID": 4444,
      "Name": "Jaylen Brown",
      "Position": "SG",
      "Started": true
    }
  ]
}
```
```

--------------------------------

### Example Widget HTML Snippet

Source: https://sportsdata.io/developers/widgets-guide

This is an example of an HTML tag used to embed a specific widget, such as the 'futures-comparison' widget for the NFL. The 'client' and 'league' parameters are configured through the widget builder and sales.

```html
<fdw-futures-comparison client="3" league="nfl"></fdw-futures-comparison>
```

--------------------------------

### Starting Lineups API

Source: https://sportsdata.io/developers/data-dictionary/nba

Retrieve starting lineup information for a given date, including player details and their starting status.

```APIDOC
## GET /lineups/starting

### Description
Retrieves the starting lineup for a specific date, detailing player information and their status in the lineup.

### Method
GET

### Endpoint
/lineups/starting

### Parameters
#### Query Parameters
- **date** (string) - Required - The date for which to retrieve the starting lineup (YYYY-MM-DD).

### Response
#### Success Response (200)
- **PlayerID** (integer) - The player's unique PlayerID.
- **TeamID** (integer) - The unique ID of the team.
- **Team** (string) - The abbreviation [Key] of the team.
- **FirstName** (string) - The player's first name.
- **LastName** (string) - The player's last name.
- **Position** (string) - The player's primary position.
- **Starting** (bool) - Indicates whether this player is in the starting lineup.
- **Confirmed** (bool) - Indicates whether the 'Starting' field has been confirmed.
- **LineupStatus** (string) - Indicates whether player is starting, active, or inactive.

#### Response Example
{
  "PlayerID": 67890,
  "TeamID": 2,
  "Team": "GSW",
  "FirstName": "Stephen",
  "LastName": "Curry",
  "Position": "PG",
  "Starting": true,
  "Confirmed": true,
  "LineupStatus": "starter"
}
```

--------------------------------

### Starting Lineups API

Source: https://sportsdata.io/developers/coverages/nba

Provides the projected and confirmed starting lineups for NBA games on a given date.

```APIDOC
## GET Starting Lineups - by Date

### Description
This endpoint provides the projected & confirmed starting lineups for NBA games on a given date.

### Method
GET

### Endpoint
/LineupStartingLineups

### Parameters
#### Query Parameters
- **date** (string) - Required - The date for which to retrieve starting lineups (e.g., 'YYYY-MM-DD').

### Response
#### Success Response (200)
- **StartingLineups[]** (array) - An array of starting lineup objects.
  - **game_id** (string) - Unique identifier for the game.
  - **home_team** (string) - The home team.
  - **away_team** (string) - The away team.
  - **starting_lineups** (object) - An object containing starting players for each team.
    - **home_starters** (array) - Array of home team starting player names.
    - **away_starters** (array) - Array of away team starting player names.

#### Response Example
```json
[
  {
    "game_id": "game_abc123",
    "home_team": "Lakers",
    "away_team": "Celtics",
    "starting_lineups": {
      "home_starters": ["LeBron James", "Anthony Davis"],
      "away_starters": ["Jayson Tatum", "Jaylen Brown"]
    }
  }
]
```
```

--------------------------------

### GET /season/current

Source: https://sportsdata.io/developers/workflow-guide/nfl

Retrieves the current NFL season year. This value updates at the start of the new NFL league year.

```APIDOC
## GET /season/current

### Description
Year of the current NFL season. This value changes at the start of the new NFL league year.

### Method
GET

### Endpoint
/season/current

### Parameters
#### Query Parameters
None

### Request Example
None

### Response
#### Success Response (200)
- **integer?** (integer) - The year of the current NFL season.

#### Response Example
```json
2023
```
```

--------------------------------

### GET Play By Play [Live & Final]

Source: https://sportsdata.io/developers/workflow-guide/nba

Retrieves real-time play-by-play data for a specific game, updated live during the game.

```APIDOC
## GET Play By Play [Live & Final]

### Description
Retrieves detailed play-by-play data for a specific game, delivered live in real-time. Updates typically occur 15-20 seconds behind the TV broadcast. This feed accounts for all substitutions.

### Method
GET

### Endpoint
`/PlayByPlayLive`

### Parameters
#### Query Parameters
* **gameId** (string) - Required - The unique identifier for the game.

### Request Example
```json
{
  "example": "GET /PlayByPlayLive?gameId=12345"
}
```

### Response
#### Success Response (200)
- **PlayByPlay** (object) - Contains the live play-by-play events for the game.
- **GamePlayPlayByPlayQuarterSeries** (object) - Contains aggregated game, play-by-play, quarter, and series information.

#### Response Example
```json
{
  "example": "{\"gameId\": \"12345\", \"plays\": [{\"playId\": \"P1\", \"clock\": \"11:55\", \"team\": \"Home\", \"player\": \"Player X\", \"type\": \"Made Shot\", \"points\": 2}, ...]}"
}
```
```

--------------------------------

### GET Play By Play [Live & Final]

Source: https://sportsdata.io/developers/coverages/nba

Retrieves a detailed record of every play for a specific game, with live updates during the game and a final list of all plays once completed.

```APIDOC
## GET Play By Play [Live & Final]

### Description
Retrieves a detailed record of each individual play within a game, including its type, outcome, involved players and teams, and associated statistics. This data is delivered live in real-time throughout the game and also includes the final list of all plays once the game is completed and verified.

### Method
GET

### Endpoint
`/PlayByPlayLive`

### Parameters
#### Query Parameters
* **gameId** (string) - Required - The unique identifier for the game.

### Request Example
```json
{
  "example": "GET /PlayByPlayLive?gameId=12345"
}
```

### Response
#### Success Response (200)
- **PlayByPlay** (object) - Contains a list of all plays in the game, with detailed information for each play, updated live.

#### Response Example
```json
{
  "example": "{\"gameId\": \"12345\", \"plays\": [ {\"playId\": \"P1\", \"type\": \"3-pointer\", \"player\": \"PlayerA\", \"stats\": {...}}, ... ]}"
}
```
```

--------------------------------

### Play By Play [Live & Final]

Source: https://sportsdata.io/developers/coverages/mlb

Delivers a real-time feed of every play in a game, including live updates and a final compilation of all plays once the game is completed.

```APIDOC
## GET Play By Play [Live & Final]

### Description
Each invididual play, its type and outcome, complete with player and team stats down to the play level, delivered live in real-time, called by game.

### Method
GET

### Endpoint
/games/{gameId}/playbyplay/live

### Parameters
#### Path Parameters
- **gameId** (string) - Required - The unique identifier for the game.

### Response
#### Success Response (200)
- **PlayByPlay** (object) - The live play-by-play data for the specified game.

#### Response Example
```json
{
  "gameId": "string",
  "plays": [
    {
      "playId": "string",
      "description": "string",
      "outcome": "string",
      "stats": {},
      "playersInvolved": []
    }
  ]
}
```
```

--------------------------------

### Utility Endpoints - GET Season

Source: https://sportsdata.io/developers/coverages/wnba

Retrieves the current season year. This value updates at the start of the new league year.

```APIDOC
## GET Season - Current

### Description
Year of the current season. This value changes at the start of the new league year. For leagues that run over two years, this is the year the season starts, not ends.

### Method
GET

### Endpoint
/season/current

### Parameters
#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **Season** (object)
  - **year** (integer) - The current season year.

#### Response Example
```json
{
  "year": 2024
}
```
```

--------------------------------

### GET /v3/nhl/projections/json/StartingGoaltendersByDate/{date}

Source: https://sportsdata.io/developers/api-documentation/nhl

Returns projected and confirmed starting goaltenders on the specified date.

```APIDOC
## GET /v3/nhl/projections/json/StartingGoaltendersByDate/{date}

### Description
Returns projected and confirmed starting goaltenders on the specified date.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/nhl/projections/json/StartingGoaltendersByDate/{date}

### Query Parameters
- **key** (string) - Required - Subscription Key for API access.

### URL Template Parameters
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.
- **date** (string) - Required - The date of the game(s). Examples: `2021-OCT-12`, `2021-DEC-09`.

### Response
#### Success Response (200)
- **StartingGoaltenders[]** (array) - An array of starting goaltender objects.

### Response Example
```json
[
  {
    "GameID": 12345,
    "PlayerID": 11111,
    "TeamAbbreviation": "BOS",
    "GoaltenderName": "Linus Ullmark",
    "IsStarting": true,
    "ProjectedStart": true
  },
  {
    "GameID": 12345,
    "PlayerID": 22222,
    "TeamAbbreviation": "TOR",
    "GoaltenderName": "Ilya Samsonov",
    "IsStarting": true,
    "ProjectedStart": false
  }
]
```
```

--------------------------------

### Lineups - by Date

Source: https://sportsdata.io/developers/api-documentation/soccer

Returns confirmed starting lineups and substitute benches for a specified competition and date.

```APIDOC
## GET /v4/soccer/stats/json/LineupsByDate/{competition}/{date}

### Description
Returns confirmed starting lineups and substitute benches for a specified competition and date.

### Method
GET

### Endpoint
`https://api.sportsdata.io/v4/soccer/stats/json/LineupsByDate/{competition}/{date}`

### Parameters
#### Path Parameters
- **competition** (string) - Required - An indication of a soccer competition/league. This value can be the CompetitionId or the Competition Key. Possible values include: `EPL`, `1`, `MLS`, `8`, etc.
- **date** (string) - Required - The date of the game(s). Examples: `2017-02-27`, `2017-09-01`.

#### Query Parameters
- **key** (string) - Required - Subscription Key.

### Request Example
```json
{
  "example": "https://api.sportsdata.io/v4/soccer/stats/json/LineupsByDate/EPL/2023-10-27?key=YOUR_KEY"
}
```

### Response
#### Success Response (200)
- **PlayerGameBasic[]** (array) - An array of PlayerGameBasic objects.

#### Response Example
```json
{
  "example": "[PlayerGameBasic Object Array]"
}
```
```

--------------------------------

### GET Games (Basic) - by Date [Live & Final]

Source: https://sportsdata.io/developers/workflow-guide/nba

Retrieves basic live game data including quarter, time, and score information. This endpoint is suitable for real-time score updates without detailed game state.

```APIDOC
## GET Games (Basic) - by Date [Live & Final]

### Description
This endpoint simply delivers the quarter, time, quarter scores, and total score live; no gameday info is provided.

### Method
GET

### Endpoint
`/games/basic`

### Query Parameters
- **date** (string) - Required - The date for which to retrieve game data (e.g., YYYY-MM-DD).

### Request Example
```
GET /games/basic?date=2023-10-27
```

### Response
#### Success Response (200)
- **ScoreBasic[]** (array) - An array of ScoreBasic objects containing live score information.

#### Response Example
```json
[
  {
    "quarter": "3",
    "time": "05:30",
    "homeScore": 75,
    "awayScore": 72,
    "totalScore": {
      "home": 75,
      "away": 72
    }
  }
]
```
```

--------------------------------

### GET /v3/nhl/scores/json/StartingGoaltenders/{date}

Source: https://sportsdata.io/developers/api-documentation/nhl

Retrieves projected and confirmed starting goaltenders for a specified date.

```APIDOC
## GET /v3/nhl/scores/json/StartingGoaltenders/{date}

### Description
Returns projected and confirmed starting goaltenders on the specified date.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/nhl/scores/json/StartingGoaltenders/{date}

### Parameters
#### Query Parameters
- **key** (string) - Required - Your unique API subscription key.

#### URL Template Parameters
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.
- **date** (string) - Required - The date for which to retrieve starting goaltenders. Examples: `2023-10-26`.

### Response
#### Success Response (200)
- **StartingGoaltenders[]** (array) - An array of starting goaltender objects.

#### Response Example
```json
[
  {
    "GameID": 15000,
    "Date": "2023-10-26T00:00:00",
    "HomeTeam": "BOS",
    "AwayTeam": "TOR",
    "HomeStartingGoaltender": {
      "PlayerID": 1001,
      "Name": "Linus Ullmark",
      "Starts": 10,
      "Wins": 8,
      "Losses": 2,
      "OvertimeLosses": 0,
      "Shutouts": 1
    },
    "AwayStartingGoaltender": {
      "PlayerID": 1003,
      "Name": "Ilya Samsonov",
      "Starts": 9,
      "Wins": 6,
      "Losses": 3,
      "OvertimeLosses": 0,
      "Shutouts": 0
    }
  }
]
```
```

--------------------------------

### Starting Goaltenders - by Date

Source: https://sportsdata.io/developers/data-dictionary/nhl

Retrieves starting goaltender information for games on a specific date. This endpoint provides details about the goaltenders for both the home and away teams.

```APIDOC
## GET /api/v1/StartingGoaltenders

### Description
Retrieves starting goaltender information for games on a specific date. This endpoint provides details about the goaltenders for both the home and away teams.

### Method
GET

### Endpoint
/api/v1/StartingGoaltenders

### Parameters
#### Query Parameters
- **date** (string) - Required - The date for which to retrieve starting goaltender information (e.g., YYYY-MM-DD).
- **season** (integer) - Optional - The season year (e.g., 2021 for the 2021-2022 season).
- **seasonType** (integer) - Optional - The type of season (1=Regular Season; 2=Preseason; 3=Postseason; 5=AllStar; 6=Exhibition).

### Request Example
```json
{
  "example": "GET /api/v1/StartingGoaltenders?date=2023-10-24&season=2023"
}
```

### Response
#### Success Response (200)
- **GameID** (integer) - The unique ID of the game.
- **Season** (integer) - The end year of the season.
- **SeasonType** (integer) - The type of season.
- **Day** (datetime) - The date of the game.
- **DateTime** (datetime) - The date and time of the game in US Eastern Time.
- **Status** (string) - The game's status.
- **HomeTeamID** (integer) - The unique ID of the home team.
- **HomeTeam** (string) - The abbreviation of the home team.
- **AwayTeamID** (integer) - The unique ID of the away team.
- **AwayTeam** (string) - The abbreviation of the away team.
- **HomeGoaltender** (object) - Information about the home goaltender.
  - **PlayerID** (integer)
  - **TeamID** (integer)
  - **Team** (string)
  - **FirstName** (string)
  - **LastName** (string)
  - **JerseyNumber** (integer)
  - **Confirmed** (boolean)
- **AwayGoaltender** (object) - Information about the away goaltender.
  - **PlayerID** (integer)
  - **TeamID** (integer)
  - **Team** (string)
  - **FirstName** (string)
  - **LastName** (string)
  - **JerseyNumber** (integer)
  - **Confirmed** (boolean)

#### Response Example
```json
{
  "example": [
    {
      "GameID": 12345,
      "Season": 2023,
      "SeasonType": 1,
      "Day": "2023-10-24T00:00:00",
      "DateTime": "2023-10-24T19:00:00",
      "Status": "Scheduled",
      "HomeTeamID": 1,
      "HomeTeam": "BOS",
      "AwayTeamID": 2,
      "AwayTeam": "TOR",
      "HomeGoaltender": {
        "PlayerID": 101,
        "TeamID": 1,
        "Team": "BOS",
        "FirstName": "Linus",
        "LastName": "Ullmark",
        "JerseyNumber": 35,
        "Confirmed": true
      },
      "AwayGoaltender": {
        "PlayerID": 102,
        "TeamID": 2,
        "Team": "TOR",
        "FirstName": "Ilya",
        "LastName": "Samsonov",
        "JerseyNumber": 30,
        "Confirmed": true
      }
    }
  ]
}
```
```

--------------------------------

### Get NFL Futures Data Example

Source: https://sportsdata.io/developers/workflow-guide/nfl

This JSON object represents an example of NFL Futures data, including event details, season information, and associated betting markets. It is used to display futures odds and related information for a given season.

```json
{
  "BettingEventID": 1292,
  "Name": "NFL Futures 2025-26",
  "Season": 2025,
  "BettingEventTypeID": 2,
  "BettingEventType": "Future",
  "StartDate": "2026-02-15T00:00:00",
  "Created": "2024-04-29T08:56:12",
  "Updated": "2024-04-29T08:56:12",
  "ScoreID": null,
  "GlobalScoreID": null,
  "GameStatus": null,
  "Quarter": null,
  "AwayTeam": null,
  "HomeTeam": null,
  "AwayTeamID": null,
  "HomeTeamID": null,
  "GlobalAwayTeamID": null,
  "GlobalHomeTeamID": null,
  "AwayTeamScore": null,
  "HomeTeamScore": null,
  "TotalScore": null,
  "AwayRotationNumber": null,
  "HomeRotationNumber": null,
  "GameStartTime": null,
  "BettingMarkets": []
}
```

--------------------------------

### GET /SchedulesBasic/{season}

Source: https://sportsdata.io/developers/api-documentation/mlb

Fetches a basic schedule of games for a specified season, including essential game details.

```APIDOC
## GET /SchedulesBasic/{season}

### Description
Returns a full schedule of games for the specified season. Including home and away teams, date, start time, stadium, and game status.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/mlb/scores/json/SchedulesBasic/{season}

### Parameters
#### Path Parameters
- **season** (string) - Required - Year of the season (with optional season type). Examples: `2018`, `2018PRE`, `2018POST`, `2018STAR`, `2019`, etc.

#### Query Parameters
- **key** (string) - Required - Your unique API key. Subscription required.
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.

### Response
#### Success Response (200)
- **ScheduleBasic[]** - An array of basic schedule objects.

#### Response Example
```json
[
  {
    "gameID": 12345,
    "season": "2023",
    "gameDate": "2023-07-20",
    "startTime": "18:00:00",
    "awayTeam": "Team A",
    "homeTeam": "Team B",
    "stadium": "Stadium Name",
    "gameStatus": "Scheduled"
  }
]
```
```

--------------------------------

### GET /v3/nfl/projections/json/UpcomingDfsSlateOwnershipProjections

Source: https://sportsdata.io/developers/api-documentation

Returns DFS Slates which have not yet started for which we have DFS Ownership projections.

```APIDOC
## GET /v3/nfl/projections/json/UpcomingDfsSlateOwnershipProjections

### Description
Returns DFS Slates which have not yet started for which we have DFS Ownership projections.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/nfl/projections/json/UpcomingDfsSlateOwnershipProjections

### Parameters
#### Query Parameters
- **key** (string) - Required - Subscription Key
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.

### Request Example
```json
{
  "example": "GET https://api.sportsdata.io/v3/nfl/projections/json/UpcomingDfsSlateOwnershipProjections?key=YOUR_API_KEY&format=JSON"
}
```

### Response
#### Success Response (200)
- **DfsSlateWithOwnershipProjection[]** (array) - An array of DFS slate objects with ownership projections.

#### Response Example
```json
{
  "example": "[ { \"SlateID\": 67890, \"SlateName\": \"Upcoming Slate 1\", \"Players\": [ { \"PlayerID\": 33333, \"Name\": \"Player C\", \"OwnershipPercentage\": 12.0 } ] }, { \"SlateID\": 54321, \"SlateName\": \"Upcoming Slate 2\", \"Players\": [ { \"PlayerID\": 44444, \"Name\": \"Player D\", \"OwnershipPercentage\": 8.5 } ] } ]"
}
```
```

--------------------------------

### GET /SchedulesBasic/{season}

Source: https://sportsdata.io/developers/api-documentation/nba

Returns a lightweight schedule of games for the specified season, including essential game details like teams, date, time, and stadium.

```APIDOC
## GET /SchedulesBasic/{season}

### Description
Returns a lightweight schedule of games for the specified season. Includes home and away teams, date, start time, stadium, and game status.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/nba/scores/json/SchedulesBasic/{season}

### Parameters
#### Query Parameters
- **key** (string) - Required - Your subscription key.
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.

#### Path Parameters
- **season** (string) - Required - Year of the season (with optional season type). Examples: `2018`, `2018PRE`, `2018POST`, `2018STAR`, `2019`.

### Request Example
```json
{
  "example": "https://api.sportsdata.io/v3/nba/scores/json/SchedulesBasic/2019?key=YOUR_API_KEY&format=JSON"
}
```

### Response
#### Success Response (200)
- **ScheduleBasic[]** (array) - An array of basic schedule objects.

#### Response Example
```json
{
  "example": "[Basic Schedule Objects]"
}
```
```

--------------------------------

### GET Play By Play [Live & Final]

Source: https://sportsdata.io/developers/workflow-guide/nfl

Retrieves live play-by-play data for a game, updating in near real-time (15-20 seconds behind broadcast). This data includes individual play details, player stats, and team stats.

```APIDOC
## GET Play By Play [Live & Final]

### Description
Retrieves live play-by-play data for a game, updating in near real-time (15-20 seconds behind broadcast). This data includes individual play details, player stats, and team stats.

### Method
GET

### Endpoint
/PlayByPlay

### Parameters
#### Query Parameters
- **gameId** (string) - Required - The unique identifier for the game.

### Request Example
```json
{
  "gameId": "example_game_id"
}
```

### Response
#### Success Response (200)
- **PlayByPlay** (object) - Contains detailed live play-by-play information.
- **PlayPlayByPlayPlayStatQuarterScoreScoringPlayStadium** (object) - Contains related statistical and scoring data.

#### Response Example
```json
{
  "PlayByPlay": {
    "gameId": "example_game_id",
    "plays": [
      {
        "playId": "play_1",
        "description": "Patrick Mahomes sacked for a loss of 5 yards.",
        "stats": {
          "sacks": 1
        }
      }
    ]
  },
  "PlayPlayByPlayPlayStatQuarterScoreScoringPlayStadium": {
    "quarter": 3,
    "score": {
      "home": 21,
      "away": 17
    }
  }
}
```
```

--------------------------------

### GET /betting/markets/bygame

Source: https://sportsdata.io/developers/workflow-guide/ncaa-basketball

Retrieves all available betting markets and their outcomes for a given game ID.

```APIDOC
## GET /betting/markets/bygame

### Description
Returns the markets of all available types (e.g. Player Props, Team Props) and available outcomes for a given GameID.

### Method
GET

### Endpoint
`/betting/markets/bygame`

### Parameters
#### Query Parameters
- **GameID** (string) - Required - The unique identifier for the game.

### Request Example
```json
{
  "example": "GET /betting/markets/bygame?GameID=12345"
}
```

### Response
#### Success Response (200)
- **BettingMarket[]** (array) - An array of BettingMarket objects.

#### Response Example
```json
{
  "example": "[ { \"MarketID\": \"m1\", \"Name\": \"Player X Over Y.5 Rebounds\", \"Outcomes\": [ { \"OutcomeID\": \"o1\", \"Name\": \"Over\", \"Odds\": 1.90 } ] } ]"
}
```
```

--------------------------------

### GET /games (Basic) - by Week [Live & Final]

Source: https://sportsdata.io/developers/coverages/nfl

Retrieves live game clock, quarter scores, and total scores for a given week. This endpoint does not include down and distance or other game day information.

```APIDOC
## GET /games (Basic) - by Week [Live & Final]

### Description
This endpoint simply delivers the game clock and quarter and total scores live; no down and distance and no gameday info such as weather. This endpoint provides 'Live & Final' data.

### Method
GET

### Endpoint
/games (Basic) - by Week [Live & Final]

### Parameters
#### Query Parameters
- **week** (string) - Required - The week for which to retrieve game scores.

### Response
#### Success Response (200)
- **ScoreBasic[]** (array) - An array of basic score objects with live updates.

#### Response Example
{
  "example": "[ScoreBasic Object Array with live data]"
}
```

--------------------------------

### GET Player Season Stats

Source: https://sportsdata.io/developers/workflow-guide/ncaa-basketball

Returns all season-long stats for all players for a given season.

```APIDOC
## GET Player Season Stats

### Description
Returns all season-long stats (i.e. the season total, not each individual game record) for all players for a given season.

### Method
GET

### Endpoint
/playerseasonstats/season/{season}

### Parameters
#### Path Parameters
- **season** (string) - Required - The season for which to retrieve player season stats.

### Response
#### Success Response (200)
- **PlayerSeason[]** (array) - An array of player season data.

#### Response Example
```json
[
  {
    "example": "PlayerSeason data"
  }
]
```
```
Tokens:
Raw