Skip to main content
V1 endpoints use a line-based data model (lines / line_periods) instead of the market-based model in V2. V1 is still fully supported, but new features and market types are V2-only. For new integrations, use V2 Events instead.
V1 REST GET endpoints that return odds accept the optional odds_format query parameter. It defaults to american; see Choose an odds format for supported values and which response fields change.

V1 vs V2 Data Model


Store your key in the THERUNDOWN_API_KEY environment variable and send it in the X-TheRundown-Key header. Legacy query authentication remains available for compatibility; use header authentication for new integrations. Do not put keys in URLs.

Endpoints

Returns a single event with V1 line data (moneyline, spread, total per affiliate).

Parameters

Returns all events for a sport on a date with V1 line data.

Parameters

Returns events with the earliest recorded V1 line data (opening lines) for a sport and date.

Parameters

Same as the events-by-sport-and-date endpoint above.
Returns events with the final V1 line data recorded before event start.
Returns the event schedule for a sport with cursor-based pagination. Useful for loading upcoming games, filtering by team, conference, or division.

Parameters

MLB schedule rows include game_number (1 or 2 for a true doubleheader) and game_type (doubleheader, makeup, or doubleheader_makeup). Both are omitted for ordinary games.

V1 Line Structure

In V1 responses, each event contains a lines object keyed by affiliate_id. Each affiliate’s line object has:
When include=all_periods is used, lines may be omitted or null. Read period-specific data from line_periods, grouped by affiliate ID and then period key: