Events & Scores

Retrieve live and historical event data, scores, standings, and play-by-play across all supported leagues.

List Events

GET/v1/events

List events with filtering and pagination.

Parameter	Type	Required	Description
league	string	No	Filter by league: nba, nfl, mlb, nhl, ncaa_basketball, ncaa_football
sport	string	No	Filter by sport
date	string	No	YYYY-MM-DD
from	string	No	Inclusive range start in YYYY-MM-DD or ISO 8601
to	string	No	Inclusive end in ISO 8601, or exclusive next-day boundary for YYYY-MM-DD
status	string	No	scheduled, in_progress, final
limit	number	No	Max 100, default 25
page	number	No	Page number, default 1

Response

{
  "success": true,
  "data": [
    {
      "eventId": "nba-ev-311286",
      "leagueId": "nba",
      "sport": "basketball",
      "homeTeamName": "Boston Celtics",
      "awayTeamName": "Los Angeles Lakers",
      "startTime": "2026-03-09T23:30:00.000Z",
      "status": "final",
      "scores": { "home": 112, "away": 105 }
    }
  ],
  "meta": { "count": 1, "total": 142, "page": 1, "pages": 6 }
}

Live Events

GET/v1/events/live

Get all in-progress events with live scores and game clock.

Parameter	Type	Required	Description
league	string	No	Filter by league: nba, nfl, mlb, nhl, ncaa_basketball, ncaa_football

Response

{
  "success": true,
  "data": [
    {
      "eventId": "nba-ev-311301",
      "leagueId": "nba",
      "sport": "basketball",
      "homeTeamName": "Golden State Warriors",
      "awayTeamName": "Milwaukee Bucks",
      "startTime": "2026-03-18T00:00:00.000Z",
      "status": "in_progress",
      "isStub": false,
      "scores": { "home": 87, "away": 79 },
      "period": "Q3",
      "clock": "4:22"
    }
  ],
  "meta": { "count": 1 }
}

Today's Events

GET/v1/events/today

Get all events on the current America/New_York calendar day.

Parameter	Type	Required	Description
league	string	No	Filter by league: nba, nfl, mlb, nhl, ncaa_basketball, ncaa_football

Response

{
  "success": true,
  "data": [
    {
      "eventId": "nba-ev-311310",
      "leagueId": "nba",
      "sport": "basketball",
      "homeTeamName": "Miami Heat",
      "awayTeamName": "Chicago Bulls",
      "startTime": "2026-03-18T23:30:00.000Z",
      "status": "scheduled",
      "isStub": false,
      "scores": null
    }
  ],
  "meta": { "count": 14, "date": "2026-03-18", "timeZone": "America/New_York" }
}

Single Event

GET/v1/events/:eventId

Get full details for a single event by its ID.

Parameter	Type	Required	Description
eventId	string	Yes	Event identifier

Play-by-Play

GET/v1/events/:eventId/play-by-play

Get play-by-play data for a specific event.

Parameter	Type	Required	Description
eventId	string	Yes	Event identifier

Scores by League

GET/v1/leagues/:leagueId/scores

Get scores for all games in a league on a given date.

Parameter	Type	Required	Description
leagueId	string	Yes	League identifier
date	string	No	YYYY-MM-DD, defaults to today

Standings

GET/v1/leagues/:leagueId/standings

Get current standings for a league.

Parameter	Type	Required	Description
leagueId	string	Yes	League identifier
conference	string	No	Filter by conference
division	string	No	Filter by division