events

List events

get/v1/events

Request

  • Base URL: https://lumify.ai
  • URL: https://lumify.ai/v1/events
  • Auth: HTTP bearer

Query parameters

sportstring nullable

Sport slug: nfl, nba, mlb, nhl, tennis, soccer…

leaguestring nullable

League slug: nfl, nba, atp, mls…

statusstring nullable

Event status: scheduled|inprogress|final|…

datestring nullable

UTC date YYYY-MM-DD (single day)

fromstring nullable

UTC start date YYYY-MM-DD

tostring nullable

UTC end date YYYY-MM-DD (inclusive)

season_idinteger nullable

Filter by season ID

team_idinteger nullable

Filter to events where this team participates. Resolve ids via GET /v1/teams?q=…

after_idinteger nullable

Cursor: return events with id > after_id

limitinteger
include_scoresboolean

Inline participants + scores in each event. Intended for small result sets (≤ 200 events). Shares the 20/min score-poll budget with GET /events/{id}/score; prefer GET /events/{id}/stream for live boards.

has_recommendboolean nullable

When true, return only events with at least one recommended bet (has_recommend=1 in intelligence). Requires intelligence pipeline to have run.

sortstring

Sort order: 'time' (chronological, default) or 'status' (Live → Delayed/Upcoming → Final → Cancelled/Postponed). Cursor pagination (after_id) is not supported with sort=status.

Response

Paginated event list, newest first within the requested window

totalinteger
next_after_idinteger nullable

Changes

No recorded changes to this operation across all 1 revision of this API.