List Season Stats

get

https://api.sportsstack.io/api/v1/seasons/{season_year}/season-stats

Returns season-level stats for players and teams.

Notes:

team_id filters stats for that team entity only (not all players on the team).
Use player_id/team_id for single entities, or player_ids/team_ids for bulk.
for_entity_type can limit results to player or team.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

season_year

string

required

Year for season

Query Params

league_id

string

required

Filter by league ID — accepts a UUID or league abbreviation (e.g., 'NFL', 'NBA'). See GET /api/v1/leagues for all leagues.

type

string

Filter by stats type (e.g., 'projections', 'boxscore')

source

string

Filter by logical projection source (for example 'ftn_models' or 'ftn_models_jeff')

season_stage

string

Filter by season stage (PRE, REG, POST)

for_entity_type

string

enum

Filter by entity type ('player' or 'team')

Allowed:

for_entity_id

string

Filter by entity ID (player or team)

for_entity_ids

array of uuids

Filter by multiple entity IDs (player or team). Accepts repeated params or comma-separated values.

for_entity_ids

player_id

string

Filter by player ID (single entity)

player_ids

array of uuids

Filter by multiple player IDs (repeated or comma-separated)

player_ids

team_id

string

Filter by team ID (single entity)

team_ids

array of uuids

Filter by multiple team IDs (repeated or comma-separated)

team_ids

return_source_id_format

string

Include source mappings from the specific integration (i.e. 'sportradar') will return a source_mappings object with the mappings for the respective objects

count

boolean

When true, compute exact total_count/total_pages pagination metadata. When false, pagination is cursor-style (x-total-count is 0 and the next link advances one page at a time) to avoid an expensive count on large result sets. Defaults to the server's configured behavior.

page

integer

≥ 1

Defaults to 1

Page number for page/per_page pagination. Do not combine with limit/offset.

per_page

integer

1 to 1000

Defaults to 500

Number of items per page (max 1000). Do not combine with limit/offset.

Responses

Callback

200SeasonStats Response

401Unauthorized

404Not Found