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 identifier
sport	string	No	Filter by sport
date	string	No	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": {
    "total": 142,
    "page": 1,
    "pages": 6,
    "events": [
      {
        "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 }
      }
    ]
  }
}

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 identifier

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",
      "scores": { "home": 87, "away": 79 },
      "period": "Q3",
      "clock": "4:22"
    }
  ]
}

Today's Events

GET/v1/events/today

Get today's scheduled events.

Parameter	Type	Required	Description
league	string	No	Filter by league identifier

Response

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

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-playPro+

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