Jobs /
Get job runs
Required permission
Project > Jobs > General > Read
Path parameters
projectId
string requiredID of the project
jobId
string requiredID of the job
Query parameters
per_page
integerThe number of results to display per request. Maximum of 100 results per page.
page
integerThe page number to access.
cursor
stringThe cursor returned from the previous page of results, used to request the next page.
Response body
- {object}
Response object.
data
{object} requiredResult data.
runs
[array] requiredAn array of job run objects.
- {object}
id
string requiredThe ID of the job run
active
integer requiredWhether the run is currently in progress
one of0, 1backoffLimit
integer requiredThe number of attempts to retry this job run before it is marked as failed.
completions
integer requiredThe number of times this job run has concluded successfully or with an error.
concluded
boolean requiredHas the job run finished?
failed
integer requiredWhether this job run failed to complete successfully
one of0, 1runName
string requiredThe name of the job run
status
string requiredA string representing the status of the job. Either SUCCESS, RUNNING or FAILED
one ofSUCCESS, RUNNING, FAILEDsucceeded
integer requiredWhether this job run completed successfully
one of0, 1startedAt
string requiredThe timestamp when the job run started.
concludedAt
string requiredThe timestamp when the job run concluded.
pagination
{object} requiredData about the endpoint pagination.
hasNextPage
boolean requiredIs there another page of results available?
cursor
stringThe cursor to access the next page of results.
count
number requiredThe number of results returned by this request.
GET /v1/projects/{projectId}/jobs/{jobId}/runs
Example response
200 OK
JSON
{
"data": {
"runs": [
{
"id": "d34582a4-35bd-4c71-8e7c-e36999b88723",
"active": 0,
"backoffLimit": 0,
"completions": 1,
"concluded": true,
"failed": 0,
"runName": "example-job-5fcf67bc56e1913e21d49504",
"status": "SUCCESS",
"succeeded": 0,
"startedAt": "2020-12-08T11:47:08Z",
"concludedAt": "2020-12-08T11:52:08Z"
}
]
},
"pagination": {
"hasNextPage": false,
"count": 1
}
}