Skip to main content

​
Returns

Returns a list of Run objects. A listed run carries no launches.

​
Example

​
Parameters

​
string | list[string]
The ID or IDs of the product(s) to filter runs by.
​
string | list[string]
The ID or IDs of the version(s) to filter runs by.
​
string | list[string]
The ID or IDs of the run(s) to retrieve.
​
string | list[string]
The label or labels to filter runs by.
​
string | list[string]
Filter runs by status. Valid values are RUNNING, COMPLETED, FAILED and CANCELLED. Other string values are sent to the API unchanged, so values added in newer API versions can be used; the API rejects invalid ones.
​
str | int
Filter runs created at or after this timestamp. Accepts an ISO 8601 string (e.g. '2024-01-01T00:00:00Z') or a Unix timestamp in seconds.
​
str | int
Filter runs created at or before this timestamp. Accepts an ISO 8601 string (e.g. '2024-12-31T23:59:59Z') or a Unix timestamp in seconds.
​
string
Sort runs by creation date. Valid values are "asc" and "desc".
​
int
Number of runs to skip before collecting results. Use it for pagination.
​
int
Maximum number of runs to return in a single request.
At least one of product_ids, version_ids or ids must be passed. The other filters narrow the result but do not satisfy this requirement on their own.