get
https://api.sharpsports.io/v1/players/historicData
Game logs for every player on a team's current roster.
Authorization
🔐 Private API Key
Product Required: This endpoint requires the historicData product subscription.
Returns game-by-game player statistics for every player on a team's currently-active roster in a single request. Players are resolved from active roster spots at request time.
Required Query Parameter
| Parameter | Type | Description |
|---|---|---|
team | string | Team ID with TEAM_ prefix or the team's full name (case-insensitive, e.g. Los Angeles Lakers). |
Optional Query Parameters
| Parameter | Type | Description |
|---|---|---|
gamesBack | integer | Most recent N completed games per player (counts distinct games, not stat rows). |
seasonType | string | Filter by season type (REG, PRE, POST). |
metric | string | One metric ID or a comma-separated list (e.g. METR_points,METR_assists). |
Error Responses
400—teamquery param missing, or a full-name lookup matched more than one team.404— No team matches the supplied ID or name.
Response Shape
Returns a bare list — one entry per rostered player. Each entry has a player object (PlayerSerializerLight) and a historicData list of {event, stats} rows for that player.
[
{
"player": {
"id": "PLYR_abc123def456",
"firstName": "LeBron",
"lastName": "James",
"fullName": "LeBron James",
"sportId": "SPRT_basketball",
"sportsdataioId": "20000571",
"oddsjamId": null,
"sportradarId": null
},
"historicData": [
{
"event": {
"id": "EVNT_xyz789abc012",
"sport": "Basketball",
"league": "NBA",
"name": "Lakers @ Heat",
"nameSpecial": null,
"startTime": "2024-01-15T01:20:00Z"
},
"stats": [
{ "metric": { "id": "METR_points", "name": "Points" }, "value": 28 },
{ "metric": { "id": "METR_assists", "name": "Assists" }, "value": 10 }
]
}
]
}
]