List runs
List all runs with optional filtering by connector-id, connector-version, site-id, state, process-id, and run-id
Sign in to run requests against the CDE API.
Authorization
oAuth2AuthCode AuthorizationBearer <token>
In: header
Query Parameters
id?string
filter by run UUID
connector-id?string
filter by connector UUID
connector-version?string
filter by connector version
site-id?string
filter by site ID
state?string
filter by state
process-id?string
filter by process UUID
from?integer
starting item
limit?integer
items per page
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://loading/runs"{
"data": [
{
"id": "019e6e75-3950-78ff-b119-0de52d409f31",
"connector-id": "019e6e75-3939-77c4-8bf7-3f2c63a802a7",
"connector-version": "2.0.0",
"state": "finished",
"process-id": "019e6e75-3950-7927-b119-0de52dd2667f",
"site-id": 1001,
"site-name": "Site 1",
"project-id": 300,
"project-name": "Project 1",
"account-id": 600,
"account-name": "Account 1",
"exit-code": 0,
"container-api-docker-image": null,
"container-api-version-constraint": null,
"cli-command": null,
"registered-secrets": null,
"authentications": null,
"connector-setup-config": null,
"started-at": "2025-10-29T13:09:16+01:00",
"finished-at": "2025-10-29T13:14:16+01:00",
"created-at": "2025-01-04T10:00:00+00:00"
},
{
"id": "019e6e75-394b-749b-a062-ef37fac47675",
"connector-id": "019e6e75-3929-7194-9b5d-4a7c0488a6fa",
"connector-version": "1.1.0",
"state": "finished",
"process-id": "019e6e75-394b-74c7-a062-ef37fb2c6fda",
"site-id": 1001,
"site-name": "Site 1",
"project-id": 635,
"project-name": "Project 1",
"account-id": 508,
"account-name": "Account 1",
"exit-code": 0,
"container-api-docker-image": null,
"container-api-version-constraint": null,
"cli-command": null,
"registered-secrets": null,
"authentications": null,
"connector-setup-config": null,
"started-at": "2025-10-29T12:09:16+01:00",
"finished-at": "2025-10-29T12:14:16+01:00",
"created-at": "2025-01-03T10:00:00+00:00"
},
{
"id": "019e6e75-3947-714a-9d51-6dfb7d247fd6",
"connector-id": "019e6e75-3929-7194-9b5d-4a7c0488a6fa",
"connector-version": "1.0.1",
"state": "failed",
"process-id": "019e6e75-3947-7176-9d51-6dfb7dead71b",
"site-id": 1002,
"site-name": "Site 2",
"project-id": 650,
"project-name": "Project 2",
"account-id": 748,
"account-name": "Account 2",
"exit-code": 1,
"container-api-docker-image": null,
"container-api-version-constraint": null,
"cli-command": null,
"registered-secrets": null,
"authentications": null,
"connector-setup-config": null,
"started-at": "2025-10-29T11:09:16+01:00",
"finished-at": "2025-10-29T11:14:16+01:00",
"created-at": "2025-01-02T10:00:00+00:00"
},
{
"id": "019e6e75-3941-7b4a-911f-223071944e54",
"connector-id": "019e6e75-3929-7194-9b5d-4a7c0488a6fa",
"connector-version": "1.0.0",
"state": "finished",
"process-id": "019e6e75-3941-7b72-911f-223071d6da7b",
"site-id": 1001,
"site-name": "Site 1",
"project-id": 828,
"project-name": "Project 1",
"account-id": 203,
"account-name": "Account 1",
"exit-code": 0,
"container-api-docker-image": null,
"container-api-version-constraint": null,
"cli-command": null,
"registered-secrets": null,
"authentications": null,
"connector-setup-config": null,
"started-at": "2025-10-29T10:09:16+01:00",
"finished-at": "2025-10-29T10:14:16+01:00",
"created-at": "2025-01-01T10:00:00+00:00"
}
],
"metadata": {
"from": 0,
"limit": 100,
"count": 4,
"total": 4,
"next": null
},
"message": "successful operation",
"resource": "run"
}{
"message": "Bad request.",
"errors": {
"from": "This value should be either positive or zero."
}
}{
"message": "You have to be authorized to access this resource."
}{
"message": "Access denied for user."
}How is this guide?