---
title: "List active and recent query jobs"
method: GET
path: "/query/jobs"
tags: ["Query"]
---

# List active and recent query jobs

`GET /query/jobs`

Returns all running jobs and recently completed jobs (kept for `job_ttl`, default 5 minutes).
Useful for Web UI job manager and debugging. The optional `status` filter accepts
canonical values (`running`, `done`, `error`, `canceled`) and the aliases
`complete`, `failed`, and `cancelled`.

## Query parameters

- `status` 'running' | 'done' | 'error' | 'canceled' | 'complete' | 'failed' | 'cancelled'

## Response `200`

Job list

- JobListResponse
  - `data` object, required
    - `jobs` object[], required
      - `job_id` string
      - `status` 'running' | 'done' | 'error' | 'canceled'
      - `query` string
      - `created_at` string, date-time

---

[API](https://skmtc.net/lynxbase/apis/lynxdb-api.md) · [All operations](https://skmtc.net/lynxbase/apis/lynxdb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lynxbase/lynxdb-api/versions/4363a070c444/schema)