List Runs

GET {{baseUrl}}/api/v1/runs?limit=25&startingFrom=<integer>&orderBy=id&orderByDirection=desc&runType=deploy&runStatus=failed&environmentID=<string>&detail=false

Get a collection of information about runs.

Request Params

KeyDatatypeRequiredDescription
limitnumberThe maximum number of runs to return.
startingFromstringThe starting run ID, runStartTime, or runEndTime (exclusive) for paging the query results.
orderBystringThe field used to order results.
orderByDirectionstringThe sort order for query results.
runTypestringA run type to filter the query results.
runStatusstringA status value to filter the query results.
environmentIDstringAn environment ID to filter the query results.
detailbooleanInclude the full detail of the run.

HEADERS

KeyDatatypeRequiredDescription
Acceptstring

RESPONSES

status: OK

{&quot;limit&quot;:&quot;\u003cinteger\u003e&quot;,&quot;orderBy&quot;:&quot;id&quot;,&quot;orderByDirection&quot;:&quot;desc&quot;,&quot;data&quot;:[{&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;runType&quot;:&quot;refresh&quot;,&quot;runStatus&quot;:&quot;completed&quot;,&quot;reRunID&quot;:&quot;\u003cstring\u003e&quot;,&quot;runStartTime&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;runEndTime&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;environmentID&quot;:&quot;\u003cstring\u003e&quot;,&quot;runFailureReason&quot;:&quot;\u003cstring\u003e&quot;},{&quot;id&quot;:&quot;\u003cinteger\u003e&quot;,&quot;runType&quot;:&quot;deploy&quot;,&quot;runStatus&quot;:&quot;waitingToRun&quot;,&quot;reRunID&quot;:&quot;\u003cstring\u003e&quot;,&quot;runStartTime&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;runEndTime&quot;:&quot;\u003cdateTime\u003e&quot;,&quot;environmentID&quot;:&quot;\u003cstring\u003e&quot;,&quot;runFailureReason&quot;:&quot;\u003cstring\u003e&quot;}]}