Find all updates to the Darts v2 API
Season Summaries Pagination
🗓️ Release Date 08/31/2026
We've added pagination to the Season Summaries endpoint of our Darts API.
Use the optional start (also accepted as offset) query parameter to page through results. The feed returns 100 events per page by default, so start sets the number of events to skip: add start=100 for the second page, start=200 for the third, and so on. Requests without start behave as before, returning the first 100 events.
To know how many pages to expect, check the X-Max-Results response header, which reports the total number of events available for the request.
This pagination follows the same pattern used across our other Global APIs, such as the Soccer API — so if you already subscribe to those products, you can reuse your existing pagination logic here.
See below for a sample request.
⭐ Benefit
Retrieve complete season summary data for large seasons that exceed the default 100-event response, by paging through results with a simple start offset — without hitting a truncated feed.
📋 Recommended Actions
- Add the optional
start(oroffset) query parameter to Season Summaries requests to page through seasons with more than 100 events (e.g.start=100for the second page,start=200for the third). - Treat 100 as the fixed page size and increment
startby 100 per page. - Read the
X-Max-Resultsresponse header to determine the total number of events available, and page until you have retrieved that many rather than guessing at the last page. - No change is needed for existing integrations —
startis optional and requests without it return the first 100 events as before. - If you already integrate pagination for another Global API (such as the Soccer API), you can reuse that same logic here, as the parameters and behavior are consistent.
☑️ Sample Request:
curl --location 'https://api.sportradar.com/darts/trial/v2/en/seasons/sr:season:137526/summaries.xml?start=100' \
--header 'x-api-key: YOUR_API_KEY'🔢 Products
| Sport | Product | Version(s) |
|---|---|---|
| Darts | Darts API | v2 |
🔁 Endpoints Affected
Active Season Indicator
| Release Date | Feeds Affected | Benefit |
|---|---|---|
| 08/28/2023 | Sport Events Created | Added a active_season attribute for newly created matches appearing in the Sport Events Created endpoint.When marked as true this will signify that an added match is part of an active season. |
<sport_event_created id="sr:sport_event:43393169" active_season="true" created_at="2023-08-30T14:42:39+00:00"/>
<sport_event_created id="sr:sport_event:43393167" active_season="true" created_at="2023-08-30T14:42:39+00:00"/>
<sport_event_created id="sr:sport_event:43393165" active_season="true" created_at="2023-08-30T14:42:38+00:00"/>
<sport_event_created id="sr:sport_event:43393163" active_season="true" created_at="2023-08-30T14:42:37+00:00"/>
<sport_event_created id="sr:sport_event:43393029" active_season="true" created_at="2023-08-30T14:37:40+00:00"/>{
"generated_at": "2023-08-30T14:47:30+00:00",
"sport_events_created": [
{
"id": "sr:sport_event:43393169",
"active_season": true,
"created_at": "2023-08-30T14:42:39+00:00"
},
{
"id": "sr:sport_event:43393167",
"active_season": true,
"created_at": "2023-08-30T14:42:39+00:00"
},
{
"id": "sr:sport_event:43393165",
"active_season": true,
"created_at": "2023-08-30T14:42:38+00:00"
},
{
"id": "sr:sport_event:43393163",
"active_season": true,
"created_at": "2023-08-30T14:42:37+00:00"
}
]
}Cup Round Data
| Release Date | Feeds Affected | Benefit |
| 03/20/2023 | Season Links | Added order, state, and winner_id to cup rounds in the Season Links endpoint.These new fields can be leveraged to determine the status, order, and winner of a cup round within a season/tournament. |
Pagination Update to Season Probabilities
| Release Date | Feeds Affected | Benefit |
| 03/03/2023 | Season Probabilities | Added pagination to the Season Probabilities endpoint for several APIs. Going forward, the first 200 events will be displayed. To retrieve further events additional query string parameters will be required. For example, to load the next 200 events you will need to append &start=200 to the call and to load the next 200 add &start=400 and so on. |
Category Data
| Release Date | Feeds Affected | Benefit |
| 01/20/2023 | Competition Info | Added the category element to the Competition Info endpoint. This includes category id, name, and country_code. The category will be represented by the country or International to better distinguish the country designation. |
'updated' Attributes for Push Feeds
| Release Date | Feeds Affected | Benefit |
| 11/29/2022 | Push Events | Added updated and updated_time flags to the Push Events feed. This update will better display which game events have been updated. |
'Competitor Merge Mappings' Endpoint
| Release Date | Feeds Affected | Benefit |
| 08/23/2022 | Competitor Merge Mappings | Added the Competitor Merge Mappings endpoint to a variety of APIs. This feed provides the valid Sportradar Id in cases when two competitors have been merged into one. This feed was previously present in the Soccer API. |
'Sport Events Created' Endpoint
| Release Date | Feeds Affected | Benefit |
| 06/29/2022 | Sport Events Created | Our new Sport Events Created endpoint provides a list of all events created within the last 24 hours. Send requests to this endpoint as needed to assist in locating and storing newly created events. |
Competition Gender
| Release Date | Feeds Affected | Benefit |
| 03/11/2022 | Competition Info Competitions List Competitor Summaries Daily Summaries Head to Head Live Summaries Season Info Season Probabilities Season Summaries Sport Event Summary Sport Event Timeline | Added competition gender to several endpoints. |
Category Updates
| Release Date | Feeds Affected | Update |
| 11/02/2021 | Competitions | Added category id, category name, and category country_code to the Competitions feed. |
Season Competitor Standings
| Release Date | Feeds Affected | Update |
| 09/15/2021 | Season Competitors Season Links Seasons | Added data to support three new seasonal data feeds. |
Seasons Disabled Endpoint
| Release Date | Feeds Affected | Update |
| 01/14/2021 | Seasons Disabled | Added the “season – disabled” data point to support the Seasons Disabled endpoint. |
Venue Capacity
| Release Date | Feeds Affected | Update |
| 06/09/2020 | Season Info | Added the following data points: competition_status, venue_reduced_capacity, and venue_reduced_capacity_max. |
Group IDs Added to Standings
| Release Date | Feeds Affected | Update |
| 06/09/2020 | Season Standings | Updated group ids in the Season Standings feed to include “sr:group:” |
'Best Of' Support
| Release Date | Feeds Affected | Update |
| 10/17/2019 | Competitor Summaries Daily Summaries Head to Head Live Summaries Season Probabilities Season Summaries Sport Event Summaries Sport Event Timeline | Added Mode Best Of to the competition information. |
'Rankings' & 'Push Events' Endpoints
| Release Date | Feeds Affected | Update |
| 06/10/2019 | Rankings Push Events | Added data points to support the new Rankings and Push Events feeds. |
is_parent Flag
| Release Date | Feeds Affected | Update |
| 06/03/2019 | Competitions List | Added Boolean flag for parent competitions: is_parent. |
Walkover Match Status
| Release Date | Feeds Affected | Update |
| 06/03/2019 | Match Endpoints | Added walkover as a match_status value. |
'Live Timelines' & 'Live Timelines Delta' Endpoints
| Release Date | Feeds Affected | Update |
| 04/29/2019 | Live Timelines Live Timelines Delta | Added support for the Live Timelines and Live Timelines Delta feeds. |
'Competition Info' Endpoint
| Release Date | Feeds Affected | Update |
| 04/29/2019 | Competition Info | Added support for the Competition Information endpoint. |
Group Name and Stage Info
| Release Date | Feeds Affected | Update |
| 01/10/2019 | Competitor Summaries Daily Summaries Head to Head Live Summaries Season Info Season Probabilities Season Standings Season Summaries Sport Event Summary Sport Event Timeline | Added group_name to the group element and added stage information to the Season Standings endpoint. |
Removed Period Name
| Release Date | Feeds Affected | Update |
| 12/10/2018 | Sport Event Timeline | Removed “event – period_name” from the Sport Event Timeline. |
API Release
| Release Date | Feeds Affected | Update |
| 09/24/2018 | All | Initial release of Darts v2. |
