Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

The Rundown V1 Events API

Events with line-based odds (V1 legacy)

The Rundown V1 Events API is one of 14 APIs that The Rundown publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include V1 Events. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and pricing.

This API exposes 8 operations across 8 paths, and defines 16 schemas. It is described by OpenAPI 3.0.3, at version 2.0.0.

Requests are made against a single base URL, https://therundown.io.

8 operations 8 paths 16 schemas 8 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0.0
Base URL
https://therundown.io/api/v2
Authentication
API Key, API Key
Terms of Service
Resource Areas
1

Authentication & Security 2

The Rundown V1 Events API declares 2 security schemes for authenticating requests. An API key is passed in the query as key (ApiKeyQuery). An API key is passed in the header as X-Therundown-Key (ApiKeyHeader). By default, every request must be authenticated.

  • ApiKeyQuery — API key as query parameter
  • ApiKeyHeader — API key as request header

Paths & Operations 8

Across 8 paths, the API surfaces 8 operations — 8 GET. Each is listed below with its method, path, parameters, and response codes.

V1 Events 8

Events with line-based odds (V1 legacy)

GET
/api/v1/events/{eventId}
Get a single event with lines
v1GetEventByID 3 params → 200
GET
/api/v1/events/{eventId}/lines/{lineId}
Get event by line ID
v1GetByLineID 3 params → 200
GET
/api/v1/sports/{sportID}/events/{date}
Get events with lines for a sport and date
v1GetEventsBySportAndDate 8 params → 200
GET
/api/v1/sports/{sportID}/openers/{date}
Get opening lines for a sport and date
v1GetOpenersBySportAndDate 8 params → 200
GET
/api/v1/sports/{sportID}/closing/{date}
Get closing lines for a sport and date
v1GetClosingBySportAndDate 8 params → 200
GET
/api/v1/sports/{sportID}/widget/events
Get events for widget display
v1GetWidgetEvents 5 params → 200
GET
/api/v1/sports/{sportID}/widget/opening
Get opening lines for widget
v1GetWidgetOpening 3 params → 200
GET
/api/v1/sports/{sportID}/widget/closing
Get closing lines for widget
v1GetWidgetClosing 3 params → 200

Schemas 16

The contract defines 16 schemas that model the data the API accepts and returns. The most detailed are Score (18 properties), V1LinePeriods (14 properties), V1Event (14 properties), Schedule (11 properties). Each schema is shown below with its type and property counts.

Pitcher
object
6 properties
V1LinePeriods
object
14 properties
Meta
object
1 property
Schedule
object
11 properties
Score
object
18 properties
V1Moneyline
object
8 properties
TeamNormalized
object
10 properties
Affiliate
object
4 properties
V1Spread
object
11 properties
Conference
object
3 properties
V1Event
object
14 properties
V1Line
object
8 properties
V1Total
object
11 properties
V1EventsResponse
object
2 properties
Region
object
2 properties
Division
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

therundown-v1-events-api-openapi.yml Raw ↑

Other APIs The Rundown publishes across the network.

The Rundown V1 Delta API
The Rundown V1 Lines API
The Rundown V1 Reference API
The Rundown V1 Sports API
The Rundown V1 WebSocket API
The Rundown V2 Events API
The Rundown V2 Markets API
The Rundown V2 Players API
The Rundown V2 Reference API
The Rundown V2 Sports API
The Rundown V2 Stats API
The Rundown V2 Teams API