Sport API

The Sport API exposes functionality related to sport events. This makes it possible to synchronize WHATS'ON with external sport metadata providers.

This document describes the available calls of version 1.0.0 on a high level. To get the details of each field and information on which values are required and allowed, please see the OpenAPI definition. This definition can also be used to generate the client code for your development environment.

The Sport API contains following entities:

Concept	Definition
League	A collection of seasons with a common sport kind, location and ruleset (e.g. Premier League).
Season	A collection of sport events that is held in a certain period (e.g. Premier League 2018-2019). Is part of a league.
Sport event	Represents a single event that is held (e.g. Liverpool v Arsenal). Is part of a season.
Team	Represents a sport team (e.g. Barcelona). Can be linked to a sport event or a season.
Player	Represents a sport player (e.g. Lionel Messi). Can be linked to a sport event or a season.

The following diagram represents how these different entities are related to each other.

A league represents the highest level of sport concepts. It is a container for seasons and can be linked to a series. A season contains sport events and can be linked to a content season. Typically, a season is created for each time a league is held. The individual games of which a season is made up are represented by sport events. These can be linked to episodes. A service is available that automatically generates and links content to leagues, seasons and sport events. The rights that belong to these sport concepts are always held on the linked content.