Skip to main content
GET
/
runs
List runs
curl --request GET \
  --url https://api.cloudcruise.com/runs \
  --header 'cc-key: <api-key>'
[
  {
    "session_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "status": "execution.success",
    "created_at": "2026-02-15T10:00:00Z",
    "workflow_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "workspace_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "execution_start": "2026-02-15T10:00:01Z",
    "execution_end": "2026-02-15T10:00:30Z",
    "dry_run": false
  }
]

Authorizations

​
cc-key
string
header
required

API key-based authentication. Provide your CloudCruise API key in the cc-key header.

Query Parameters

​
start_time
string<date-time>

ISO 8601 timestamp for the earliest run creation time to include. Cannot be older than 1 year. Defaults to 24 hours ago if not provided.

Example:

"2026-02-14T00:00:00Z"

​
end_time
string<date-time>

ISO 8601 timestamp for the latest run creation time to include. Must be greater than or equal to start_time and cannot be in the future.

Example:

"2026-02-15T23:59:59Z"

​
workflow_id
string<uuid>

Filter runs by workflow ID

​
status
enum<string>

Filter runs by execution status

Available options:
execution.queued,
execution.start,
execution.failed,
execution.success,
execution.paused,
execution.stopped,
execution.requeued
​
credential_id
string

Filter runs by vault credential (permissioned_user_id)

​
workflow_ids
string<uuid>[]

Filter runs by multiple workflow IDs

​
credential_ids
string[]

Filter runs by multiple vault credential IDs (permissioned_user_id)

​
statuses
enum<string>[]

Filter runs by multiple execution statuses

Available options:
execution.queued,
execution.start,
execution.failed,
execution.success,
execution.paused,
execution.stopped,
execution.requeued
​
limit
integer
default:1000

Maximum number of runs to retrieve

Required range: 1 <= x <= 10000
​
cursor
string<date-time>

ISO 8601 timestamp for cursor-based pagination. Returns only runs with created_at strictly before this timestamp. Use the created_at value of the last row from the previous page as the cursor for the next request. When the number of returned rows is less than the requested limit, there are no more pages.

Example:

"2026-02-15T10:00:00Z"

Response

Filtered runs successfully retrieved

​
session_id
string<uuid>
required

Unique identifier for the run session

Example:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

​
status
enum<string>
required

Current execution status of the run

Available options:
execution.queued,
execution.start,
execution.failed,
execution.success,
execution.paused,
execution.stopped,
execution.requeued
Example:

"execution.success"

​
created_at
string<date-time> | null

When the run was created

Example:

"2026-02-15T10:00:00Z"

​
workflow_id
string<uuid> | null

Identifier for the workflow that was executed

Example:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

​
workspace_id
string<uuid> | null

Identifier for the workspace the run belongs to

Example:

"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

​
execution_start
string<date-time> | null

When execution began

Example:

"2026-02-15T10:00:01Z"

​
execution_end
string<date-time> | null

When execution completed

Example:

"2026-02-15T10:00:30Z"

​
dry_run
boolean | null

Whether this was a dry run

Example:

false