Productsup

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.
GET
/runs

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://cde.staging.productsup.com/runs"
{
  "data": [
    {
      "id": "01a10fc7-c32b-70ae-b264-979f670de559",
      "connector-id": "01a10fc7-c31c-7cf5-9311-b776828f5e73",
      "connector-version": "2.0.0",
      "state": "finished",
      "process-id": "01a10fc7-c32b-70ca-b264-979f676d04a2",
      "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": "01a10fc7-c329-7193-ba42-e21ce029bd78",
      "connector-id": "01a10fc7-c314-767e-8833-92df1c900552",
      "connector-version": "1.1.0",
      "state": "finished",
      "process-id": "01a10fc7-c329-71b7-ba42-e21ce0fb5cfb",
      "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": "01a10fc7-c326-7cd5-8e3b-3048b77d30e2",
      "connector-id": "01a10fc7-c314-767e-8833-92df1c900552",
      "connector-version": "1.0.1",
      "state": "failed",
      "process-id": "01a10fc7-c326-7cf9-8e3b-3048b84601d0",
      "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": "01a10fc7-c323-755e-93ee-19ff031f1934",
      "connector-id": "01a10fc7-c314-767e-8833-92df1c900552",
      "connector-version": "1.0.0",
      "state": "finished",
      "process-id": "01a10fc7-c323-758a-93ee-19ff03b179cf",
      "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."
}