Darts API – Season Summaries Pagination
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
