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 Sports API

Sport listings, dates, and teams (V2)

The Rundown V2 Sports 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 Sports. 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 9 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 9 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 V2 Sports 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.

V2 Sports 8

Sport listings, dates, and teams (V2)

GET
/api/v2/sports
List all sports
v2GetSports → 200
GET
/api/v2/sports/dates
Get available dates for multiple sports
v2GetDatesBySportIDs 3 params → 200
GET
/api/v2/sports/events/{date}
Get events across sports for a date
v2GetEventsByDate 3 params → 200
GET
/api/v2/sports/markets/{date}
Get available markets by date
v2GetMarketsByDate 3 params → 200
GET
/api/v2/sports/{sportID}/teams
Get teams for a sport
v2GetTeamsBySport 1 param → 200
GET
/api/v2/sports/{sportID}/dates
Get available dates for a sport
v2GetDatesBySportID 3 params → 200
GET
/api/v2/sports/{sportID}/divisions
Get divisions for a sport
v2GetDivisionsBySport 1 param → 200
GET
/api/v2/sports/{sportID}/conferences
Get conferences for a sport
v2GetConferencesBySport 1 param → 200

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are Market (9 properties), Team (8 properties), Division (4 properties), Conference (3 properties). Each schema is shown below with its type and property counts.

SportsResponse
object
1 property
Team
object
8 properties
Market
object
Market definition. The linevalueisparticipant flag indicates whether the line value represents a participant name (true) or a numeric value like a spread/total…
9 properties
Conference
object
3 properties
TeamsResponse
object
1 property
DivisionsResponse
object
1 property
Sport
object
2 properties
ConferencesResponse
object
1 property
Division
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

therundown-v2-sports-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 Events API
The Rundown V2 Markets API
The Rundown V2 Players API
The Rundown V2 Reference API
The Rundown V2 Stats API
The Rundown V2 Teams API