GuidesRelease Log
Coverage MatrixDocumentationChange LogLog InContact Us
Release Log

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 (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