# List jobs by status in a queue

Returns a paginated list of jobs with a specific status (finished, failed, active, submitted, retries, schedule, dlq) from a specific queue.

RBAC:
- requires ANY of Jobs.Read, Jobs.Manage

Endpoint: GET /api/v1/jobs/lists
Version: 1.0
Security: header

## Query parameters:

  - `limit` (integer,null)
    Maximum number of jobs to return

  - `listKind` (string, required)
    Job status category: finished, failed, active, submitted, retries, schedule, or dlq

  - `offset` (integer,null)
    Number of items to skip for pagination

  - `queue` (string,null)
    Queue name to list jobs from (not required for dlq)

## Response 200 fields (application/json):

  - `list` (array, required)

  - `list.jobHash` (string, required)

  - `list.job` (string, required)

  - `list.queueName` (string, required)

  - `list.tries` (integer)

  - `list.createdAt` (string,null)
    Example: "2022-03-10T16:15:50Z"

  - `list.startTime` (string,null)
    Example: "2022-03-10T16:15:50Z"

  - `list.lastTryAt` (string,null)
    Example: "2022-03-10T16:15:50Z"

  - `list.lastError` (string,null)

  - `list.endTime` (string,null)
    Example: "2022-03-10T16:15:50Z"

  - `total` (integer, required)

## Response 400 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 401 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation

## Response 403 fields (application/json):

  - `errorCode` (string, required)
    Error code

  - `message` (string, required)
    Error message

  - `docUrl` (string)
    Link to documentation