Skip to main content

Sports API

The Sports API provides access to sporting events organized by league or sport.

Endpoints

MethodEndpointDescription
GET/v2/leagues/{slug}/eventsGet events by league slug
GET/v2/sports/{slug}/eventsGet events by sport slug

Get League Events

Retrieve events for a specific league:
GET /v2/leagues/nfl/events

Path Parameters

ParameterTypeDescription
slugstringLeague slug (e.g., nfl, nba, mlb)

Query Parameters

ParameterTypeDescription
limitintegerPagination limit
offsetintegerPagination offset
excludeEventIdarrayEvent IDs to exclude
typestringType: sport (default) or futures
sectionstringSection: general (default) or trending

Get Sport Events

Retrieve events for all leagues under a sport:
GET /v2/sports/football/events

Path Parameters

ParameterTypeDescription
slugstringSport slug (e.g., football, basketball)

Query Parameters

ParameterTypeDescription
limitintegerPagination limit
offsetintegerPagination offset
excludeEventIdarrayEvent IDs to exclude
typestringType: sport (default) or futures
sectionstringSection: general (default) or trending

Teams

For fetching team information, use the Sports (Legacy) API.