Skip to main content
GET
/
api
/
v1
/
runs
# List all jobs
curl http://127.0.0.1:8005/api/v1/runs

# Filter by status
curl "http://127.0.0.1:8005/api/v1/runs?status=running"

# Paginated with session filter
curl "http://127.0.0.1:8005/api/v1/runs?session_id=project-alpha&page=1&page_size=10"

{
  "jobs": [
    {
      "job_id": "run_abc123",
      "status": "running",
      "created_at": "2025-01-01T00:00:00Z",
      "session_id": "project-alpha"
    },
    {
      "job_id": "run_def456",
      "status": "succeeded",
      "created_at": "2025-01-01T00:05:00Z",
      "session_id": null
    }
  ],
  "total": 100,
  "page": 1,
  "page_size": 20
}
Retrieve a paginated list of all async jobs with optional status filtering.
​
status
string
Filter jobs by status. One of: queued, running, succeeded, failed, cancelled.
​
session_id
string
Filter jobs by session identifier.
​
page
integer
default:"1"
Page number for pagination (1-indexed).
​
page_size
integer
default:"20"
Number of jobs per page. Maximum: 100.

​
Response

​
jobs
array
required
Array of job objects.
​
total
integer
required
Total number of jobs matching the filter.
​
page
integer
required
Current page number.
​
page_size
integer
required
Number of jobs per page.

​
Job Object

​
jobs[].job_id
string
required
Unique job identifier.
​
jobs[].status
string
required
Current job status.
​
jobs[].created_at
string
required
ISO 8601 timestamp of job creation.
​
jobs[].session_id
string
Session identifier if provided during submission.
# List all jobs
curl http://127.0.0.1:8005/api/v1/runs

# Filter by status
curl "http://127.0.0.1:8005/api/v1/runs?status=running"

# Paginated with session filter
curl "http://127.0.0.1:8005/api/v1/runs?session_id=project-alpha&page=1&page_size=10"

{
  "jobs": [
    {
      "job_id": "run_abc123",
      "status": "running",
      "created_at": "2025-01-01T00:00:00Z",
      "session_id": "project-alpha"
    },
    {
      "job_id": "run_def456",
      "status": "succeeded",
      "created_at": "2025-01-01T00:05:00Z",
      "session_id": null
    }
  ],
  "total": 100,
  "page": 1,
  "page_size": 20
}

​
Error Responses

StatusDescription
400Bad request - invalid query parameters
500Internal server error

​
See Also