Docs
Coverage MatrixDocumentationChange LogLog InContact Us
Docs

Change Log

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 (or offset) query parameter to Season Summaries requests to page through seasons with more than 100 events (e.g. start=100 for the second page, start=200 for the third).
  • Treat 100 as the fixed page size and increment start by 100 per page.
  • Read the X-Max-Results response 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 — start is 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

SportProductVersion(s)
DartsDarts APIv2

🔁 Endpoints Affected



Active Season Indicator

Release DateFeeds AffectedBenefit
08/28/2023Sport Events CreatedAdded 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 DateFeeds AffectedBenefit
03/20/2023Season LinksAdded 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 DateFeeds AffectedBenefit
03/03/2023Season ProbabilitiesAdded 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 DateFeeds AffectedBenefit
01/20/2023Competition InfoAdded 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 DateFeeds AffectedBenefit
11/29/2022Push EventsAdded 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 DateFeeds AffectedBenefit
08/23/2022Competitor Merge MappingsAdded 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 DateFeeds AffectedBenefit
06/29/2022Sport Events CreatedOur 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 DateFeeds AffectedBenefit
03/11/2022Competition 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 DateFeeds AffectedUpdate
11/02/2021CompetitionsAdded category id, category name, and category country_code to the Competitions feed.

Season Competitor Standings

Release DateFeeds AffectedUpdate
09/15/2021Season Competitors
Season Links
Seasons
Added data to support three new seasonal data feeds.

Seasons Disabled Endpoint

Release DateFeeds AffectedUpdate
01/14/2021Seasons DisabledAdded the “season – disabled” data point to support the Seasons Disabled endpoint.

Venue Capacity

Release DateFeeds AffectedUpdate
06/09/2020Season InfoAdded the following data points: competition_status, venue_reduced_capacity, and venue_reduced_capacity_max.

Group IDs Added to Standings

Release DateFeeds AffectedUpdate
06/09/2020Season StandingsUpdated group ids in the Season Standings feed to include “sr:group:”

'Best Of' Support

Release DateFeeds AffectedUpdate
10/17/2019Competitor 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 DateFeeds AffectedUpdate
06/10/2019Rankings
Push Events
Added data points to support the new Rankings and Push Events feeds.

is_parent Flag

Release DateFeeds AffectedUpdate
06/03/2019Competitions ListAdded Boolean flag for parent competitions: is_parent.

Walkover Match Status

Release DateFeeds AffectedUpdate
06/03/2019Match EndpointsAdded walkover as a match_status value.

'Live Timelines' & 'Live Timelines Delta' Endpoints

Release DateFeeds AffectedUpdate
04/29/2019Live Timelines
Live Timelines Delta
Added support for the Live Timelines and Live Timelines Delta feeds.

'Competition Info' Endpoint

Release DateFeeds AffectedUpdate
04/29/2019Competition InfoAdded support for the Competition Information endpoint.

Group Name and Stage Info

Release DateFeeds AffectedUpdate
01/10/2019Competitor 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 DateFeeds AffectedUpdate
12/10/2018Sport Event TimelineRemoved “event – period_name” from the Sport Event Timeline.

API Release

Release DateFeeds AffectedUpdate
09/24/2018AllInitial release of Darts v2.