Skip to main content
GET
/
workflows
/
{workflow_id}
/
jobs
List Jobs
curl --request GET \
  --url https://api.example.com/workflows/{workflow_id}/jobs
{
  "jobs": [
    {
      "id": "<string>",
      "workflow_id": "<string>",
      "container_id": "<string>",
      "status": "<string>",
      "trigger": "<string>",
      "scheduled_at": "<string>",
      "started_at": "<string>",
      "completed_at": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>"
    }
  ],
  "cursor": "<string>"
}
Returns all jobs associated with a specific workflow, with optional filtering by status and trigger type.

​
Path Parameters

​
workflow_id
string
required
The unique identifier of the workflow

​
Query Parameters

​
cursor
string
Pagination cursor from a previous response to fetch the next page
​
status
string
Filter jobs by status. Values: PENDING, RUNNING, COMPLETED, FAILED, CANCELLED
​
trigger
string
Filter jobs by trigger type. Values: AUTOMATIC, MANUAL

​
Response

​
jobs
array
Array of job objects
​
id
string
Unique identifier of the job
​
workflow_id
string
ID of the parent workflow
​
container_id
string
ID of the container running the job (if applicable)
​
status
string
Current status of the job
​
trigger
string
How the job was triggered (AUTOMATIC or MANUAL)
​
scheduled_at
string
ISO 8601 timestamp when the job was scheduled
​
started_at
string
ISO 8601 timestamp when execution started
​
completed_at
string
ISO 8601 timestamp when execution completed
​
created_at
string
ISO 8601 timestamp when the job was created
​
updated_at
string
ISO 8601 timestamp of last update
​
cursor
string
Pagination cursor for fetching the next page. Empty string indicates last page.

​
Examples

# List all jobs
curl -X GET 'https://api.chronoverse.dev/workflows/wf_abc123/jobs' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

# Filter by status
curl -X GET 'https://api.chronoverse.dev/workflows/wf_abc123/jobs?status=COMPLETED' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

# Filter by trigger type
curl -X GET 'https://api.chronoverse.dev/workflows/wf_abc123/jobs?trigger=MANUAL' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

# With pagination
curl -X GET 'https://api.chronoverse.dev/workflows/wf_abc123/jobs?cursor=next_page_token' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

​
Example Response

{
  "jobs": [
    {
      "id": "job_xyz789",
      "workflow_id": "wf_abc123",
      "container_id": "cnt_def456",
      "status": "COMPLETED",
      "trigger": "AUTOMATIC",
      "scheduled_at": "2026-03-03T10:00:00Z",
      "started_at": "2026-03-03T10:00:05Z",
      "completed_at": "2026-03-03T10:15:32Z",
      "created_at": "2026-03-03T09:59:58Z",
      "updated_at": "2026-03-03T10:15:32Z"
    },
    {
      "id": "job_uvw456",
      "workflow_id": "wf_abc123",
      "container_id": "cnt_ghi789",
      "status": "RUNNING",
      "trigger": "MANUAL",
      "scheduled_at": "2026-03-03T11:30:00Z",
      "started_at": "2026-03-03T11:30:02Z",
      "completed_at": "",
      "created_at": "2026-03-03T11:29:55Z",
      "updated_at": "2026-03-03T11:30:02Z"
    }
  ],
  "cursor": "next_page_token_here"
}
Use the cursor field to paginate through large result sets. An empty cursor indicates you’ve reached the last page.

Build docs developers (and LLMs) love

Get started for freeTalk to us