Event Lineups

Get starting lineups for events in a specific league. Optionally filter by date (defaults to today).

Endpoint:

GET /event/{league}/lineup/{date?}

URL Parameters

Field	Type	Description
league	string	League identifier (e.g., "nfl", "nba", "mlb")
date	string	Optional. Date in YYYY-MM-DD format (e.g., "2025-10-15"). Defaults to today if not provided.

Response Fields

Field	Type	Description
leagueId	int	League identifier
date	string	Date for the lineup in YYYY-MM-DD format
event	object	Event information (see Event Fields below)
teams	array	Array of team lineups (see Team Lineup Fields below)
meta	object	Metadata about the lineup (see Meta Fields below)

Event Fields

Field	Type	Description
id	long	Event identifier
name	string	Event name
eventStart	datetime	Event start time (UTC)
statusId	int	Event status ID (1=PREGAME, 2=LIVE, 3=FINAL, etc.)

Team Lineup Fields

Field	Type	Description
side	string	Side of the event: "AWAY" or "HOME"
team	object	Team information (see Team Fields below)
lineupStatus	string	Lineup status: "PROJECTED" or "CONFIRMED"
confirmedAt	datetime	When the lineup was confirmed (null if projected)
starters	array	Array of starting players (see Starter Fields below)

Team Fields

Field	Type	Description
id	long	Team identifier
name	string	Team name

Starter Fields

Field	Type	Description
position	string	Player position (e.g., "PG", "SG", "SF", "PF", "C" for NBA)
player	object	Player information (see Player Fields below)

Player Fields

Field	Type	Description
id	long	Player identifier
firstName	string	Player first name
lastName	string	Player last name

Meta Fields

Field	Type	Description
createdAt	datetime	Date the item was created (UTC)
updatedAt	datetime	Date the item was last updated (UTC)