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

Sport listings, dates, events, schedules (V1 legacy)

The Rundown V1 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 V1 Sports. 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 10 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 10 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 V1 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 6

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

V1 Sports 6

Sport listings, dates, events, schedules (V1 legacy)

GET
/api/v1/sports
List all sports
v1GetSports → 200
GET
/api/v1/sports/{sportID}/teams
Get teams for a sport
v1GetTeamsBySport 1 param → 200
GET
/api/v1/sports/{sportID}/divisions
Get divisions for a sport
v1GetDivisionsBySport 1 param → 200
GET
/api/v1/sports/{sportID}/conferences
Get conferences for a sport
v1GetConferencesBySport 1 param → 200
GET
/api/v1/sports/{sportID}/dates
Get available dates for a sport
v1GetDatesBySport 3 params → 200
GET
/api/v1/sports/{sportID}/schedule
Get event schedule for a sport
v1GetScheduleBySport 11 params → 200

Schemas 10

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

ScheduleResponse
object
1 property
SportsResponse
object
1 property
Team
object
8 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
ScheduledEvent
object
22 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

therundown-v1-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 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