API Reference

List Events

get
https://api.sportsstack.io/api/v1/events

This endpoint retrieves a list of events based on the provided query parameters. You can filter events either by (season year, week) OR (day, month, calendar year) season type, and league ID are additional filters.

Note: The first week of the NFL postseason is week 1, season_type = POST

For NFL and NCAAF events, the response includes both week and season_type_agnostic_week fields. The season_type_agnostic_week is a continuous week number across the entire season (regular season weeks 1-18 for NFL, 1-16 for NCAAF, with postseason weeks continuing from there).

Pagination is supported to navigate through large sets of data.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer

The year of the season. i.e. Superbowl on Feb 14th 2025 is still in the 2024 season

integer

(Use week OR season_type_agnostic_week) Week (only supported for weekly sports [NFL / NCAAF] i.e. first week of the season is 1, first week of the postseason is 1 with season_stage = POST)

integer

(Use week OR season_type_agnostic_week) Week - Agnostic of Season Type (only supported for weekly sports [NFL / NCAAF]) i.e. first week of the season is 1, first week of the postseason is 19. Setting this parameter will ignore season_type

string

Day of the month (DD) - must also pass month and year

string

Month of the year (MM) - must also pass day and year

string

Year of the event (YYYY) - must also pass day and month

string

Season type (PRE / REG / POST)

string

Filter by event status (scheduled, in_progress, completed, cancelled, postponed, time_tbd)

string
required

League ('32fa944f-b1bd-41b4-bec2-7ab269fde6fc' for NFL - https://sportsstack.readme.io/reference/apirestwebleaguecontrollerindex to see all leagues)

uuid

Filter events by participant ID (team or player common_model_id). Returns events where the specified participant is involved.

string

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

boolean
Defaults to true

Include detailed scoreboard information for each event. Scoreboard is always included by default.

integer
≥ 1
Defaults to 1

Page number

integer
1 to 1000
Defaults to 100

Number of items per page (max 1000)

Responses

Callback

Updated 3 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago