Base URL
Authentication
Send the API key in anAuthorization header on every request.
Shared request rules
- All endpoints in this reference use
GET. - All endpoints return completed runs only.
- Multi-value query params are comma-separated. Whitespace around commas is trimmed.
startDateandendDateare optional ISO-8601 datetimes. The window may not exceed 92 days; wider windows return400 {"error": "Date window must not exceed 92 days."}.- Invalid query params return
400 {"error": "Invalid query: <detail>"}. - If
startDate >= endDate, the API returns400 {"error": "Start date must be before end date."}.
Pagination
List endpoints use cursor (keyset) pagination, which stays fast on deep pages.-
Pass
pageSize(max 100, default 20) to size each page. -
Each response includes a
paginationobject: -
To fetch the next page, pass the returned
nextCursorback as thecursorquery param. WhenhasMoreisfalse,nextCursorisnull. -
totalisnullunless you passincludeTotal=true, which adds an exact match count at the cost of an extra aggregation. UsehasMorefor simple “is there more?” checks instead. -
Cursors are opaque; do not construct or parse them. An invalid cursor returns
400 {"error": "Invalid cursor."}.
Enum values
Platform filtering
executionType matches the run platform stored on each completed run. For run
groups, a group matches when at least one run in the group matches the requested
platform. For example, executionType=IOS,ANDROID returns mobile run groups.