---
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

## Changes

- **2026-04-19** `495c1db0a075` — 9 warning, 6 info
  - removed the optional property `data/jobs/items/completed_at` from the response with the `200` status
  - removed the optional property `data/jobs/items/expires_at` from the response with the `200` status
  - removed the optional property `data/jobs/items/from` from the response with the `200` status
  - removed the optional property `data/jobs/items/progress` from the response with the `200` status
  - …11 more
- **2026-03-03** `7141381739ac` — 3 breaking, 3 warning, 9 info
  - removed the enum value `canceled` from the `query` request parameter `status`
  - removed the enum value `done` from the `query` request parameter `status`
  - removed the enum value `error` from the `query` request parameter `status`
  - added the new `cancelled` enum value to the `data/jobs/items/status` response property for the response status `200`
  - …11 more

[Change history](https://skmtc.dev/lynxbase/apis/lynxdb-api/changes/query/jobs/get.md)

---

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