SportsDataIO NFL API

https://sportsdata.io/developers/api-documentation
Admin
SportsDataIO provides comprehensive sports data APIs, including real-time scores, stats, odds, and...
Tokens:368,910
Snippets:1,309
Trust Score:5.4
Update:8 months ago
Show doc for...
Tokens:
Raw
### GET /v4/soccer/projections/json/DfsSlatesByDate/{competition}/{date}

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

Returns DFS Slates which have not yet started, with their player and salary information.

```APIDOC
## GET /v4/soccer/projections/json/DfsSlatesByDate/{competition}/{date}

### Description
Returns DFS Slates which have not yet started, with their player and salary information.

### Method
GET

### Endpoint
https://api.sportsdata.io/v4/soccer/projections/json/DfsSlatesByDate/{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: `2020-02-18`.

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

### Response
#### Success Response (200)
- **DfsSlate** (array) - An array of DFS slates.

#### Response Example
```json
[
  {
    "SlateID": "slate123",
    "SlateName": "Example Slate",
    "GameDate": "2023-10-26",
    "Games": [
      {
        "GameID": "12345",
        "AwayTeamID": "67890",
        "HomeTeamID": "11223",
        "AwayTeamName": "Team A",
        "HomeTeamName": "Team B",
        "StartTime": "2023-10-26T19:00:00Z"
      }
    ],
    "Players": [
      {
        "PlayerID": "34567",
        "PlayerName": "Player One",
        "TeamID": "67890",
        "Position": "FWD",
        "Salary": 5000,
        "ProjectedPoints": 15.5
      }
    ]
  }
]
```
```

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

### GET /v4/soccer/projections/json/UpcomingDfsSlatesByCompetition/{competition}

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

Returns upcoming DFS Slates which have not yet started, with their player and salary information, by competition.

```APIDOC
## GET /v4/soccer/projections/json/UpcomingDfsSlatesByCompetition/{competition}

### Description
Returns upcoming DFS Slates which have not yet started, with their player and salary information, by competition.

### Method
GET

### Endpoint
https://api.sportsdata.io/v4/soccer/projections/json/UpcomingDfsSlatesByCompetition/{competition}

### 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.

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

### Response
#### Success Response (200)
- **DfsSlate** (array) - An array of upcoming DFS slates.

#### Response Example
```json
[
  {
    "SlateID": "slate456",
    "SlateName": "Upcoming Slate",
    "GameDate": "2023-10-27",
    "Games": [
      {
        "GameID": "54321",
        "AwayTeamID": "33445",
        "HomeTeamID": "55667",
        "AwayTeamName": "Team C",
        "HomeTeamName": "Team D",
        "StartTime": "2023-10-27T18:00:00Z"
      }
    ],
    "Players": [
      {
        "PlayerID": "98765",
        "PlayerName": "Player Two",
        "TeamID": "33445",
        "Position": "MID",
        "Salary": 6000,
        "ProjectedPoints": 12.0
      }
    ]
  }
]
```
```

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

### 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 game preparation and analysis.

```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
#### Query Parameters
- **key** (string) - Required - Your unique API key for authentication.

#### Path Parameters
- **date** (string) - Required - The date for which to retrieve starting lineups. Examples: `2021-OCT-12`, `2021-DEC-09`.

### Request Example
```
https://api.sportsdata.io/v3/nba/projections/json/StartingLineupsByDate/2021-OCT-12?key=YOUR_API_KEY
```

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

#### Response Example
```json
{
  "Lineup": [
    {
      "Game": {
        "GameID": 12345,
        "Season": 2021,
        "AwayTeam": "LAL",
        "HomeTeam": "GSW"
      },
      "PlayerID": 67890,
      "PlayerName": "LeBron James",
      "Position": "SF",
      "IsStarting": true
    }
  ],
  "StartingLineups": [
    {
      "GameID": 12345,
      "PlayerID": 67890,
      "PlayerName": "LeBron James",
      "Position": "SF",
      "Confirmed": true
    }
  ]
}
```
```

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

### GET /StartingGoaltendersByDate/{date}

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

Returns projected and confirmed starting goaltenders on the specified date.

```APIDOC
## GET /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}

### 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 subscription key.

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

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

### NFL Team Profiles Endpoint Example

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

Example GET request to retrieve basic information for all NFL teams, such as name, city, conference, division, stadium ID, and team colors.

```HTTP
GET https://api.sportsdata.io/v3/nfl/scores/json/TeamProfiles/All
```

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

### NFL Player Profiles Endpoint Example

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

Example GET request to retrieve basic biographical information for all NFL players, including their college, current team, jersey number, and position.

```HTTP
GET https://api.sportsdata.io/v3/nfl/scores/json/PlayerProfiles/All
```

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

### GET /v3/cwbb/scores/json/SchedulesBasic/{season}

Source: https://sportsdata.io/developers/api-documentation/ncaa-womens-basketball

Retrieves a lightweight schedule of games for a specified season, providing essential details like home/away teams, date, and start time.

```APIDOC
## GET /v3/cwbb/scores/json/SchedulesBasic/{season}

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

### Method
GET

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

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

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

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

#### Response Example
```json
[
  {
    "AwayTeam": "Team A",
    "HomeTeam": "Team B",
    "Date": "2023-11-10T19:00:00Z",
    "Status": "Scheduled"
  }
]
```
```

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

### GET /v4/soccer/projections/json/DfsSlatesByCompetition/{competition}

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

Retrieves upcoming DFS (Daily Fantasy Sports) slates, including player and salary information, for a specified competition that have not yet started.

```APIDOC
## GET /v4/soccer/projections/json/DfsSlatesByCompetition/{competition}

### Description
Returns upcoming DFS Slates which have not yet started, with their player and salary information, by competition.

### Method
GET

### Endpoint
https://api.sportsdata.io/v4/soccer/projections/json/DfsSlatesByCompetition/{competition}

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

#### Path Parameters
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.
- **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.

### Request Example
```json
{
  "example": "https://api.sportsdata.io/v4/soccer/projections/json/DfsSlatesByCompetition/EPL?key=YOUR_API_KEY"
}
```

### Response
#### Success Response (200)
- **DfsSlate** (object) - Contains DFS slate information.
- **DfsSlateGame** (object) - Information about games within a slate.
- **DfsSlatePlayer** (object) - Information about players within a slate.
- **GamePlayoffAggregateScore** (object) - Aggregate score for playoff games.

#### Response Example
```json
{
  "example": "{\"SlateID\":1,\"SlateName\":\"Gameweek 10\",\"StartDate\":\"2023-10-28T15:00:00Z\",\"EndDate\":\"2023-10-28T17:00:00Z\",\"Games\":[{\"GameID\":101,\"HomeTeam\":\"Team A\",\"AwayTeam\":\"Team B\",\"Players\":[{\"PlayerID\":123,\"PlayerName\":\"John Doe\",\"Position\":\"Forward\",\"Salary\":5000}]}]}" 
}
```
```

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

### GET /v3/cwbb/scores/json/Games/{season}

Source: https://sportsdata.io/developers/api-documentation/ncaa-womens-basketball

Fetches a full schedule of games for a specified season, including details like home/away teams, date, start time, game status, and quarter.

```APIDOC
## GET /v3/cwbb/scores/json/Games/{season}

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

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/cwbb/scores/json/Games/`{season}`

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

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

### Response
#### Success Response (200)
- **Game[]** (array) - An array of game objects, each containing detailed game information.

#### Response Example
```json
[
  {
    "AwayTeam": "Team A",
    "HomeTeam": "Team B",
    "Date": "2023-11-10T19:00:00Z",
    "Status": "Scheduled",
    "Quarter": null
  }
]
```
```

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

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

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

Retrieves DFS Slates that have not yet started, including player and salary information. This endpoint is called at a 15-minute interval.

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

### Description
Returns DFS Slates which have not yet started, with their player and salary information.

### Method
GET

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

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

#### Path Parameters
- **date** (string) - Required - The date of the game(s) in `YYYY-MMM-DD` format (e.g., `2017-DEC-01`).
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.

### Request Example
```
https://api.sportsdata.io/v3/nba/projections/json/DfsSlatesByDate/2017-DEC-01?key=YOUR_SUBSCRIPTION_KEY
```

### Response
#### Success Response (200)
- **DfsSlate[]** (array) - An array of DFS Slate information.
```

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

### GET /v4/soccer/projections/json/DfsSlatesByDate/{competition}

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

Retrieves upcoming DFS (Daily Fantasy Sports) slates, including player and salary information, for a specified competition that have not yet started.

```APIDOC
## GET /v4/soccer/projections/json/DfsSlatesByDate/{competition}

### Description
Returns DFS Slates which have not yet started, with their player and salary information.

### Method
GET

### Endpoint
https://api.sportsdata.io/v4/soccer/projections/json/DfsSlatesByDate/{competition}

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

#### Path Parameters
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.
- **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.

### Request Example
```json
{
  "example": "https://api.sportsdata.io/v4/soccer/projections/json/DfsSlatesByDate/EPL?key=YOUR_API_KEY"
}
```

### Response
#### Success Response (200)
- **DfsSlate** (object) - Contains DFS slate information.
- **DfsSlateGame** (object) - Information about games within a slate.
- **DfsSlatePlayer** (object) - Information about players within a slate.
- **GamePlayoffAggregateScore** (object) - Aggregate score for playoff games.

#### Response Example
```json
{
  "example": "{\"SlateID\":1,\"SlateName\":\"Gameweek 10\",\"StartDate\":\"2023-10-28T15:00:00Z\",\"EndDate\":\"2023-10-28T17:00:00Z\",\"Games\":[{\"GameID\":101,\"HomeTeam\":\"Team A\",\"AwayTeam\":\"Team B\",\"Players\":[{\"PlayerID\":123,\"PlayerName\":\"John Doe\",\"Position\":\"Forward\",\"Salary\":5000}]}]}" 
}
```
```

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

### Get DFS Slates by Date

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

Retrieves DFS slates that have not yet started, including player and salary information for a given date. This is useful for preparing for daily fantasy sports contests. Requires date parameter.

```HTTP
GET https://api.sportsdata.io/v4/soccer/projections/json/DfsSlatesByDate/{date}?key=YOUR_API_KEY
```

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

### Get Upcoming DFS Slates by Competition

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

Fetches upcoming DFS slates that have not yet started, along with their player and salary information, filtered by competition. This endpoint helps in planning for future fantasy contests. Requires competition parameter.

```HTTP
GET https://api.sportsdata.io/v4/soccer/projections/json/DfsSlatesByCompetition/{competition}?key=YOUR_API_KEY
```

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

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

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

Returns 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 for which to retrieve starting lineups. 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`.

### Response
#### Success Response (200)
- **StartingLineups[]** - An array of starting lineup objects for the specified date.

#### Response Example
```json
[
  {
    "game": {
      "game_id": "20230815_NYY@BOS",
      "home_team": "BOS",
      "away_team": "NYY"
    },
    "home_starting_lineup": [
      {"player_id": "10000031", "player_name": "Home Batter 1", "position": "1B"}
      // ... other home starters
    ],
    "away_starting_lineup": [
      {"player_id": "10000035", "player_name": "Away Batter 1", "position": "2B"}
      // ... other away starters
    ]
  }
]
```
```

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

### Lineups - by Date

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

Retrieves 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.

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

#### Response Example
```json
[
  {
    "playerGameBasic": {}
  }
]
```
```

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

### 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`.

### Request Example
```json
{
  "key": "YOUR_API_KEY",
  "format": "json"
}
```

### Response
#### Success Response (200)
- **Season** (object) - An object representing the current season with start and end dates.

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

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

### 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.

```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 unique subscription key.

#### URL Template Parameters
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.
- **season** (string) - Required - Year of the season (with optional season type). Examples: `2018`, `2018PRE`, `2018POST`, `2018STAR`, `2019`, etc.

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

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

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

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

### NFL Standings Endpoint Example

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

An example of a GET request to retrieve regular season standings for all teams in a specified NFL season. The endpoint requires the season year and format (JSON/XML).

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

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

### GET /SchedulesBasic

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

Retrieves a lightweight schedule of games for a specified season, including essential game details.

```APIDOC
## GET /SchedulesBasic

### 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

### Parameters
#### Query Parameters
- **key** (string) - Required - Your unique API key.
- **season** (string) - Required - The season for which to retrieve the schedule (e.g., "2023").

#### URL Template Parameters
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.

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

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

#### Response Example
```json
{
  "example": "[ { \"game\": { ... } } ]"
}
```
```

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

### GET /v4/soccer/odds/json/BettingFuturesBySeason/{competition}/{season}

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

Returns available Futures markets for a specified season. This endpoint does not include line movement.

```APIDOC
## GET /v4/soccer/odds/json/BettingFuturesBySeason/{competition}/{season}

### Description
Returns available Futures markets for the specified season. This endpoint does not include line movement.

### Method
GET

### Endpoint
`https://api.sportsdata.io/v4/soccer/odds/json/BettingFuturesBySeason/{competition}/{season}`

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

#### URL Template Parameters
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.
- **competition** (string) - Required - An indication of a soccer competition/league (e.g., `EPL`, `1`, `MLS`, `8`).
- **season** (string) - Required - Year of the season (e.g., `2020`, `2021`).

### Request Example
```json
{
  "example": "GET https://api.sportsdata.io/v4/soccer/odds/json/BettingFuturesBySeason/EPL/2023?key=YOUR_API_KEY"
}
```

### Response
#### Success Response (200)
- **BettingEvent[]** (array) - An array of betting event objects, each containing futures markets.

#### Response Example
```json
{
  "example": "[BettingEvent[] object structure]"
}
```
```

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

### GET DFS Slates - by 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 DFS Slates - by 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 String Parameters
- **key** (string) - Required - Subscription Required

#### URL Template Parameters
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.
- **date** (string) - Required - The date of the slates. Examples: `2017-JUL-31`, `2017-SEP-01`.

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

#### Response Example
```json
[
  {
    "SlateID": 12345,
    "SlateName": "Main Slate",
    "Operator": "DraftKings",
    "OperatorDay": "2023-10-27",
    "OperatorSlateID": "dk-20231027-12345",
    "GameIDs": [1001, 1002, 1003],
    "Players": [
      {
        "PlayerID": 10000507,
        "PlayerName": "Mike Trout",
        "Team": "LAA",
        "ProjectedPoints": 12.5,
        "Salary": 5500
      }
    ]
  }
]
```
```

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

### GET /v3/golf/odds/json/BettingMarket/{marketId}

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

Returns full line movement for the specified BettingMarket. This endpoint is intended for historical data purposes due to the size and detail of the output.

```APIDOC
## GET /v3/golf/odds/json/BettingMarket/{marketId}

### Description
Returns full line movement for the specified BettingMarket. Due to the sheer size of the output and the level of detail, it is intended for historical data purposes and NOT for the most up-to-the-second lines.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/golf/odds/json/BettingMarket/{marketId}

### Parameters
#### Path Parameters
- **marketId** (string) - Required - The MarketId of the desired market for which to pull all outcomes/bets.

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

### Request Example
```json
{
  "example": "GET https://api.sportsdata.io/v3/golf/odds/json/BettingMarket/MARKET_ID?key=YOUR_API_KEY&format=json"
}
```

### Response
#### Success Response (200)
- **BettingMarket** (object) - A betting market object containing detailed line movement.

#### Response Example
```json
{
  "example": "{ \"MarketID\": 12345, \"MarketName\": \"Some Market\", \"Outcomes\": [ { \"OutcomeID\": 67890, \"Name\": \"Yes\", \"Price\": 2.00, \"SportsbookOutcomeID\": \"SO123\", \"LineMovement\": [ { \"Timestamp\": \"2023-10-27T10:00:00Z\", \"Price\": 2.10 }, { \"Timestamp\": \"2023-10-27T10:15:00Z\", \"Price\": 2.00 } ] } ] }"
}
```
```

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

### GET /v3/mlb/projections/json/UpcomingDfsSlateOwnershipProjections

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

Retrieves DFS Slates that have not yet started and for which DFS Ownership projections are available.

```APIDOC
## GET /v3/mlb/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/mlb/projections/json/UpcomingDfsSlateOwnershipProjections

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

### Request Example
```json
{
  "example": "https://api.sportsdata.io/v3/mlb/projections/json/UpcomingDfsSlateOwnershipProjections?key=YOUR_API_KEY"
}
```

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

#### Response Example
```json
{
  "example": "{\"DfsSlateWithOwnershipProjection\": [ ... ]}"
}
```
```

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

### GET /v3/nba/odds/json/BettingFuturesBySeason/{season}

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

Retrieves available Futures markets for a specified season. This endpoint does not include line movement.

```APIDOC
## GET /v3/nba/odds/json/BettingFuturesBySeason/{season}

### Description
Returns available Futures markets for the specified season. This endpoint does not include line movement.

### Method
GET

### Endpoint
`https://api.sportsdata.io/v3/nba/odds/json/BettingFuturesBySeason/{season}`

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

#### URL Template Parameters
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.
- **season** (string) - Required - Year of the season. Examples: `2020`, `2021`, etc.

### Request Example
```json
{
  "example": "https://api.sportsdata.io/v3/nba/odds/json/BettingFuturesBySeason/2021?key=YOUR_API_KEY"
}
```

### Response
#### Success Response (200)
- **BettingEvent[]** (array) - An array of BettingEvent objects containing futures market information.

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

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

### GET /InjuredPlayers

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

Retrieves all injured players along with their injury information (status, start date, body part, and note). Requires a subscription key.

```APIDOC
## GET /InjuredPlayers

### Description
Returns all injured players along with injury information (status, start date, body part, and note).

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/nba/projections/json/InjuredPlayers

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

#### URL Template Parameters
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.

### Request Example
```json
{
  "key": "YOUR_API_KEY"
}
```

### Response
#### Success Response (200)
- **Player[]** - An array of player objects with injury details.

#### Response Example
```json
[
  {
    "PlayerID": 54321,
    "FirstName": "Kawhi",
    "LastName": "Leonard",
    "TeamID": 10,
    "Position": "F",
    "Injuries": [
      {
        "InjuryStatus": "Out",
        "StartDate": "2023-10-26",
        "BodyPart": "Knee",
        "Note": "Expected to miss 2-3 weeks"
      }
    ]
  }
]
```
```

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

### GET /v3/cbb/scores/json/SchedulesBasic/{season}

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

Returns the basic schedule for a specified season, including home and away teams, game dates, and times, without gameday information.

```APIDOC
## GET /v3/cbb/scores/json/SchedulesBasic/{season}

### Description
Returns the full schedule for a specified season without gameday information. Only includes home and away teams, the date and time of the game, and season type etc.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/cbb/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 - Subscription Required

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

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

#### Response Example
```json
[
  {
    "gameDate": "2023-11-15T19:00:00Z",
    "awayTeam": {"teamId": 101, "name": "Away Team"},
    "homeTeam": {"teamId": 102, "name": "Home Team"},
    "seasonType": "Regular"
  }
]
```
```

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

### GET /v4/soccer/projections/json/InjuredPlayers/{competition}

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

Retrieves all injured players within a specified competition, including their injury status, start date, body part, and any notes.

```APIDOC
## GET /v4/soccer/projections/json/InjuredPlayers/{competition}

### Description
Returns all injured players along with injury information (status, start date, body part, and note).

### Method
GET

### Endpoint
https://api.sportsdata.io/v4/soccer/projections/json/InjuredPlayers/{competition}

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

#### URL Template 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.

### Response
#### Success Response (200)
- **Player[]** (array) - An array of player objects, each containing injury details.

#### Response Example
```json
[
  {
    "PlayerID": 12345,
    "Name": "John Doe",
    "TeamAbbreviation": "ABC",
    "InjuryStatus": "Out",
    "InjuryBodyPart": "Ankle",
    "InjuryStartDate": "2023-10-26T00:00:00",
    "InjuryNotes": "Fractured ankle, out for 6 weeks."
  }
]
```
```

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

### GET /v3/nfl/headshots/json/Headshots

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

Retrieves cropped action headshots for active NFL players. The data is updated shortly after the season starts.

```APIDOC
## GET /v3/nfl/headshots/json/Headshots

### Description
Retrieves cropped action headshots for active NFL players. The data is updated shortly after the season starts.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/nfl/headshots/json/Headshots

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

#### URL Template Parameters
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.

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

### Response
#### Success Response (200)
- **Headshot[]** (array) - An array of headshot objects for NFL players.

#### Response Example
```json
{
  "example": [
    {
      "playerID": "12345",
      "photoURL": "https://example.com/headshots/player12345.jpg",
      "source": "USA Today/IMAGN",
      "lastUpdated": "2023-09-01T10:00:00Z"
    }
  ]
}
```
```

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

### GET /v4/soccer/scores/json/CompetitionDetails/{competition}

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

Returns comprehensive scores and game day information, both live and post-game, for a given competition. Includes half-time and full-time scores.

```APIDOC
## GET /v4/soccer/scores/json/CompetitionDetails/{competition}

### Description
Returns full scores and gameday info live and post-game, including half and full score details, delivered by competition.

### Method
GET

### Endpoint
https://api.sportsdata.io/v4/soccer/scores/json/CompetitionDetails/{competition}

### 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.

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

### Request Example
```json
{
  "example": "https://api.sportsdata.io/v4/soccer/scores/json/CompetitionDetails/EPL?key=YOUR_API_KEY"
}
```

### Response
#### Success Response (200)
- **CompetitionDetail** (object) - An object containing detailed competition and game information.

#### Response Example
```json
{
  "example": "CompetitionDetail object"
}
```
```

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

### GET /InjuredPlayers

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

Returns all injured players along with injury information (status, start date, body part, and note).

```APIDOC
## GET /InjuredPlayers

### Description
Returns all injured players along with injury information (status, start date, body part, and note).

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/nhl/projections/json/InjuredPlayers

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

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

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

### GET /GamesByDate/{date}

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

Retrieves up-to-the-second high-level game information, including live and final scores, game status, stadium details, attendance, broadcast channel, pre-game lines, and quarter-by-quarter scores for a specified date.

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

### Description
Retrieving up-to-the-second high-level game information, such as scores and game status. Returns live and final scores for all games on the specified date. Includes stadium, attendance, broadcast channel, game status, pre-game lines (moneyline, spread, total), and quarter-by-quarter scores. Ideal for score tickers, live dashboards, and checking game status updates.

### Method
GET

### Endpoint
`https://api.sportsdata.io/v3/cbb/scores/json/GamesByDate/{date}`

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

#### Path Parameters
- **date** (string) - Required - The date of the game(s). Examples: `2018-FEB-27`, `2017-DEC-01`.

### Request Example
```json
{
  "example": "GET https://api.sportsdata.io/v3/cbb/scores/json/GamesByDate/2023-10-26?key=YOUR_API_KEY&format=JSON"
}
```

### Response
#### Success Response (200)
- **Game[]** (array) - An array of game objects containing live and final scores, game status, and other detailed information.

#### Response Example
```json
{
  "example": "[ { \"GameID\": \"12345\", \"Season\": \"2023\", \"AwayTeam\": { \"Key\": \"AWAY\", \"FullName\": \"Away Team\", \"Abbreviation\": \"AWY\" }, \"HomeTeam\": { \"Key\": \"HOME\", \"FullName\": \"Home Team\", \"Abbreviation\": \"HOM\" }, \"AwayScore\": 75, \"HomeScore\": 80, \"Status\": \"InProgress\", \"Quarter\": 4, \"Stadium\": { \"Name\": \"Stadium Name\", \"Attendance\": 15000 }, \"Broadcast\": { \"Network\": \"ESPN\" }, \"PreGameLines\": { \"MoneylineHome\": -150, \"SpreadAway\": 3.5, \"Total\": 155.5 } } ]"
}
```
```

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

### GET /TournamentOdds/{tournamentid}

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

Retrieves pre-tournament odds for a specific golf tournament. This data updates continuously until the tournament starts and does not include historical line movement.

```APIDOC
## GET /TournamentOdds/{tournamentid}

### Description
Returns pre-tournament odds for players, updating continuously until the tournament begins. Does not include historical line movement.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/golf/odds/json/TournamentOdds/{tournamentid}

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

#### Path Parameters
- **tournamentid** (integer) - Required - The TournamentID of a tournament. TournamentIDs can be found in the Tournaments API. Valid entries are `58`, `61`, etc.
- **format** (string) - Required - Desired response format. Valid entries are `XML` or `JSON`.

### Request Example
```json
{
  "example": "https://api.sportsdata.io/v3/golf/odds/json/TournamentOdds/58?key=YOUR_SUBSCRIPTION_KEY"
}
```

### Response
#### Success Response (200)
- **TournamentOdds** (object) - Contains odds data for the tournament.
- **PlayerTournamentOdd** (array) - List of player odds.
- **Round** (object) - Round information.
- **Tournament** (object) - Tournament details.

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

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

### Get Player Profiles by Team (API)

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

Returns roster information for a specified team, including player profiles with basic biographical details and positions. Requires a TeamId parameter to retrieve all current players on that team. A subscription key and format are also necessary.

```http
GET https://api.sportsdata.io/v4/soccer/scores/json/PlayerProfilesByTeam/{teamid}?key={key}&format={format}
```

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

### GET /v3/mlb/stats/json/TeamHittersVsPitcher/{gameid}/{team}

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

Retrieves a team's hitting statistics against the projected or confirmed starting pitcher for a specific game.

```APIDOC
## GET /v3/mlb/stats/json/TeamHittersVsPitcher/{gameid}/{team}

### Description
Returns a team's hitting stats versus the projected or confirmed starting pitcher for the specified game.

### Method
GET

### Endpoint
https://api.sportsdata.io/v3/mlb/stats/json/TeamHittersVsPitcher/{gameid}/{team}

### Parameters
#### Path Parameters
- **gameid** (integer) - Required - The GameID of an MLB game. GameIDs can be found in the Games API. Valid entries are `14620` or `16905`
- **team** (string) - Required - The abbreviation of the requested team. Examples: `SF`, `NYY`.

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

### Request Example
```json
{
  "example": "https://api.sportsdata.io/v3/mlb/stats/json/TeamHittersVsPitcher/14620/SF?key=YOUR_API_KEY&format=JSON"
}
```

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

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