Versioning

Overview

Sportradar regularly enhances our APIs to provide the most comprehensive sports data. We have adopted the following versioning strategy to provide flexibility in your development.

Versioning Strategy

Sportradar provides support for one current and two previous versions of an API. These versions are considered stable as it relates to the schema, data elements, behaviors, and formats as they will not change.

Defects in calculations or logic will be addressed at the discretion of Sportradar. Previous versions will continue to be available but are not supported, and will no longer be available to new customers. It is your responsibility to migrate to one of the current, stable versions.

To find the currently supported versions, see the Sportradar Versioning Matrix at the bottom of this page. More information about about this can be found in our Terms and Conditions.

Example Scenarios

Scenario 1: It is determined that the method used to calculate an MLB split is incorrect. The format and behavior of the API will not change. Only the actual data will change. Corrections will be made to the current version at Sportradar's discretion and released to all stable versions.

Scenario 2: A new data element is developed mid-season. The new data element will be released in the next stable version of the API. This new data element will not be added to the previous, still supported, versions.

Scenario 3: A new endpoint is created mid-season. The new endpoint will be introduced in the next stable version of the API. This new endpoint will not be added to the previous, still supported, versions.

Scenario 4: A new API version is released. When a new version is released the previous current version becomes the new supported version along with the previous supported version. When this occurs the oldest supported version becomes unsupported. For instance, when v4 of an API is released becoming the new current version, V3 and v2 of the API would be the supported previous versions, and v1 would become unsupported.

FAQs

How do I find the latest version of an API?

API versions can be found in the documentation on the Sportradar Developer Portal or in the below Sportradar API Versioning Matrix.

How often do you version up your APIs?

We aim to version up an API only when necessary due to a breaking change. Most API versions will be supported for multiple years. However, new features and releases are typically only added to the latest version of an API.

How does Sportradar notify customers when a new version is released?

When releasing a new version, we send a product announcement to the email associated with your account.

Sportradar Versioning Matrix