Skip to main content
GET
http://127.0.0.1:8005
/
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