---
title: "Player Game Stats - by Date [Live & Final]"
method: GET
path: "/v3/cbb/stats/{format}/PlayerGameStatsByDate/{date}"
tags: ["CBB v3 Stats"]
---

# Player Game Stats - by Date \[Live & Final\]

`GET /v3/cbb/stats/{format}/PlayerGameStatsByDate/{date}`

## Request

- Base URL: `https://api.sportsdata.io`
- URL: `https://api.sportsdata.io/v3/cbb/stats/{format}/PlayerGameStatsByDate/{date}`
- Auth: one of:
  - API key in header `Ocp-Apim-Subscription-Key`
  - API key in query parameter `key`
- TypeScript: <https://skmtc.dev/sportsdata/apis/cbb-api/docs/v3/cbb/stats/:format/PlayerGameStatsByDate/:date/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the box score statistical record for all involved players across a given date, updated live as the game takes place.

## Path parameters

- `format` 'JSON' | 'XML', required
- `date` string, required

## Response `200`

Success

- PlayerGame[]
  - `StatID` integer: The unique ID of the stat
  - `TeamID` integer, nullable: The unique ID of the player's team
  - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their collegiate career
  - `SeasonType` integer, nullable: The type of season that this record corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar)
  - `Season` integer, nullable: The season that the game the player is playing in occurs. Note: season is a single year that the majority of the season occurs in
  - `Name` string, nullable: Player's full name
  - `Team` string, nullable: The abbreviation [Key] of the player's team
  - `Position` string, nullable: The player's eligible position(s). Possible values: C; F; F-C; G; G-F, PG, SG, SF, PF
  - `FanDuelSalary` integer, nullable: The player's salary for FanDuel daily fantasy contests.
  - `DraftKingsSalary` integer, nullable: The player's salary for DraftKings daily fantasy contests.
  - `FantasyDataSalary` integer, nullable: The player's salary as calculated by SportsDataIO (formerly known as FantasyData). Based on the same salary cap as DraftKings contests ($50,000).
  - `YahooSalary` integer, nullable: The player's salary for Yahoo daily fantasy contests
  - `InjuryStatus` string, nullable: Injury status used to project availability. Statuses: Probable; Questionable; Doubtful; Out
  - `InjuryBodyPart` string, nullable: The player's body part(s) that are injured (e.g. Knee; Groin; Calf; Hamstring; etc.). Note: if a player has multiple injured body parts they will appear like such: Hamstring/Ankle
  - `InjuryStartDate` string, nullable: The date that the injury occurred, was first discovered, or was freshly updated
  - `InjuryNotes` string, nullable: Short description of injury involving injured body part(s), game status, player name, team name, and other extra news necessary. Notes are custom and can be unique
  - `FanDuelPosition` string, nullable: The player's eligible position(s) in FanDuel's daily fantasy sports platform.
  - `DraftKingsPosition` string, nullable: The player's eligible position in DraftKings' daily fantasy sports platform.
  - `YahooPosition` string, nullable: The player's eligible position in Yahoo's daily fantasy sports platform
  - `OpponentRank` integer, nullable: The ranking of the player's opponent with regards to fantasy points allowed.
  - `OpponentPositionRank` integer, nullable: The ranking of the player's opponent by position with regards to fantasy points allowed.
  - `GlobalTeamID` integer, nullable: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues
  - `GameID` integer, nullable: The unique ID of this game
  - `OpponentID` integer, nullable: The unique ID of the team's opponent
  - `Opponent` string, nullable: The name of the opponent
  - `Day` string, nullable: The day of the game
  - `DateTime` string, nullable: The date and time of the game
  - `HomeOrAway` string, nullable: Whether the team is home or away
  - `IsGameOver` boolean: Whether the game is over (true/false)
  - `GlobalGameID` integer, nullable: A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues.
  - `GlobalOpponentID` integer, nullable: A globally unique ID for this team's opponent. This value is guaranteed to be unique across all sports/leagues.
  - `Updated` string, nullable: The timestamp of when the record was last updated (US Eastern Time).
  - `Games` integer, nullable: The number of games played.
  - `FantasyPoints` number, nullable: Total fantasy points
  - `Minutes` integer, nullable: Total number of minutes played
  - `FieldGoalsMade` integer, nullable: Total number of field goals made
  - `FieldGoalsAttempted` integer, nullable: Total number of field goals attempted
  - `FieldGoalsPercentage` number, nullable: Total field goal percentage
  - `EffectiveFieldGoalsPercentage` number, nullable: Total effective field goals percentage
  - `TwoPointersMade` integer, nullable: Total two pointers made
  - `TwoPointersAttempted` integer, nullable: Total two pointers attempted
  - `TwoPointersPercentage` number, nullable: Total two pointers percentage
  - `ThreePointersMade` integer, nullable: Total three pointers made
  - `ThreePointersAttempted` integer, nullable: Total three pointers attempted
  - `ThreePointersPercentage` number, nullable: Total three pointers percentage
  - `FreeThrowsMade` integer, nullable: Total free throws made
  - `FreeThrowsAttempted` integer, nullable: Total free throws attempted
  - `FreeThrowsPercentage` number, nullable: Total free throws percentage
  - `OffensiveRebounds` integer, nullable: Total offensive rebounds
  - `DefensiveRebounds` integer, nullable: Total defensive rebounds
  - `Rebounds` integer, nullable: Total rebounds
  - `OffensiveReboundsPercentage` number, nullable: Total offensive rebounds percentage
  - `DefensiveReboundsPercentage` number, nullable: Total defensive rebounds percentage
  - `TotalReboundsPercentage` number, nullable: The player/team total rebounds percentage
  - `Assists` integer, nullable: Total assists
  - `Steals` integer, nullable: Total steals
  - `BlockedShots` integer, nullable: Total blocked shots
  - `Turnovers` integer, nullable: Total turnovers
  - `PersonalFouls` integer, nullable: Total personal fouls
  - `Points` integer, nullable: Total points
  - `TrueShootingAttempts` number, nullable: The player's true shooting attempts as defined here: http://www.basketball-reference.com/about/glossary.html
  - `TrueShootingPercentage` number, nullable: The player's true shooting percentage as defined here: http://www.basketball-reference.com/about/glossary.html
  - `PlayerEfficiencyRating` number, nullable: The player's linear weight efficiency rating as defined here: http://bleacherreport.com/articles/113144-cracking-the-code-how-to-calculate-hollingers-per-without-all-the-mess
  - `AssistsPercentage` number, nullable: The player's assist percentage as defined here: http://www.basketball-reference.com/about/glossary.html
  - `StealsPercentage` number, nullable: The player's steal percentage as defined here: http://www.basketball-reference.com/about/glossary.html
  - `BlocksPercentage` number, nullable: The player's block percentage as defined here: http://www.basketball-reference.com/about/glossary.html
  - `TurnOversPercentage` number, nullable: The player's turnover percentage as defined here: http://www.basketball-reference.com/about/glossary.html
  - `UsageRatePercentage` number, nullable: The player's usage rate percentage as defined here: http://www.basketball-reference.com/about/glossary.html
  - `FantasyPointsFanDuel` number, nullable: Total Fan Duel daily fantasy points scored
  - `FantasyPointsDraftKings` number, nullable: Total Draft Kings daily fantasy points scored
  - `FantasyPointsYahoo` number, nullable: Total Yahoo daily fantasy points scored

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/sportsdata/apis/cbb-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/cbb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/cbb-api/revisions/2bf9419ae396?raw)
