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 V2 Events API

Events with market-based odds (V2)

The Rundown V2 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 V2 Events. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and pricing.

This API exposes 6 operations across 6 paths, and defines 19 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.

6 operations 6 paths 19 schemas 6 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 V2 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 6

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

V2 Events 6

Events with market-based odds (V2)

GET
/api/v2/sports/{sportID}/events/{date}
Get events with markets for a sport and date
v2GetEventsBySportAndDate 10 params → 200
GET
/api/v2/sports/{sportID}/openers/{date}
Get opening lines for a sport and date
v2GetOpenersBySportAndDate 7 params → 200
GET
/api/v2/events/{eventID}
Get a single event with markets
v2GetEventByID 6 params → 200404
GET
/api/v2/events/{eventID}/openers
Get opening prices for an event
v2GetEventOpeners 5 params → 200
GET
/api/v2/events/{eventID}/best-line
Get best available line for an event
v2GetBestLineByEvent 3 params → 200
GET
/api/v2/delta
Get event changes since a delta ID
v2GetDelta 3 params → 200

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are Score (18 properties), EventV2 (12 properties), Schedule (11 properties), TeamNormalized (10 properties). Each schema is shown below with its type and property counts.

Pitcher
object
6 properties
MarketResponse
object
Market with participants and prices for a specific event
6 properties
EventV2
object
12 properties
BestAffiliateInfo
object
3 properties
BestMoneyline
object
6 properties
Meta
object
1 property
Score
object
18 properties
Schedule
object
11 properties
BestTotal
object
6 properties
BestLineResponse
object
5 properties
BestSpread
object
6 properties
TeamNormalized
object
10 properties
EventsV2Response
object
2 properties
Conference
object
3 properties
MarketParticipantResponse
object
4 properties
MarketLinesResponse
object
5 properties
MarketLinePriceResponse
object
6 properties
DeltasResponse
object
2 properties
Division
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs The Rundown publishes across the network.

The Rundown V1 Delta API
The Rundown V1 Events API
The Rundown V1 Lines API
The Rundown V1 Reference API
The Rundown V1 Sports API
The Rundown V1 WebSocket 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