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
Product | Type | Current Version | Stable Version 1 | Stable version 2 |
---|---|---|---|---|
Aussie Rules Football API | Aussie Rules Football | v3 | v2 | v1 |
Badminton API | Badminton | v2 | v1 | - |
Bandy API | Bandy | v2 | v1 | - |
Beach Soccer | Soccer | v2 | v1 | - |
Betting Insights API | Insights | v2 | - | - |
Cricket API | Cricket | v2 | - | - |
Curling API | Curling | v2 | v1 | - |
Cycling API | Cycling | v2 | - | - |
Darts API | Darts | v2 | v1 | - |
Editorial Content API | Editorial Content | v3 | - | - |
Field Hockey API | Field Hockey | v2 | v1 | - |
Floorball API | Floorball | v2 | v1 | - |
Formula 1 API | Racing | v2 | - | - |
Formula E API | Racing | v2 | - | - |
Futsal API | Futsal | v2 | v1 | - |
Global American Football API | Football | v2 | v1 | - |
Global Baseball API | Baseball | v2 | v1 | - |
Global Basketball API | Basketball | v2 | v1 | - |
Global Ice Hockey API | Hockey | v2 | v1 | - |
Golf API | Golf | v3 | v2 | - |
Handball API | Handball | v2 | v1 | - |
Images API | Images | v3 | - | - |
Indy Car API | Racing | v2 | - | - |
Indy Lights API | Racing | v2 | - | - |
Insights API | Insights | v2 | v1 | - |
MLB API | Baseball | v7 | v6.6 | v6.5 |
MMA API | Combat Sports | v2 | - | - |
MotoGP API | Racing | v2 | - | - |
NASCAR API | Racing | v3 | - | - |
NBA API | Basketball | v8 | v7 | v5 |
NBA G League | Basketball | v8 | v7 | v5 |
NCAA Football API | Football | v7 | - | - |
NCAA Men's Basketball API | Basketball | v8 | v7 | v4 |
NCAA Men's Hockey API | Hockey | v3 | - | - |
NCAA Women's Basketball API | Basketball | v8 | v7 | v3 |
NFL API | Football | v7 | v6 | v5 |
NHL API | Hockey | v7 | v6 | v5 |
Odds Comparison Futures API | Odds | v2 | - | - |
Odds Comparison Player Props API | Odds | v2 | - | - |
Odds Comparison Prematch API | Odds | v2 | - | - |
Odds Comparison Regular API | Odds | v1 | - | - |
Olympic Medals API | Olympics | v1 | - | - |
Pesapallo API | Pesapallo | v2 | v2 | - |
Probabilities API | Odds | v1 | - | - |
Rally API | Racing | v2 | - | - |
Rugby API | Rugby | v3 | v2 | - |
Snooker API | Snooker | v2 | v1 | - |
Soccer API | Soccer | v4 | v3 | - |
Soccer Advanced Analytics API | Soccer | v1 | - | - |
Soccer Extended API | Soccer | v4 | v3 | - |
Squash API | Squash | v2 | v1 | - |
Table Tennis API | Table Tennis | v2 | - | - |
Tennis API | Tennis | v3 | v2 | - |
UFL API | Football | v7 | - | - |
USFL API | Football | v7 | - | - |
Volleyball (Beach) API | Volleyball | v2 | v1 | - |
Volleyball (Indoor) API | Volleyball | v2 | v1 | - |
Waterpolo API | Waterpolo | v2 | v1 | - |
Winter Sports API | Winter Sports | v1 | - | - |
WNBA API | Basketball | v8 | v7 | v4 |
Updated 2 months ago