---
title: "Retrieves active jobs in a queue"
method: GET
path: "/api/v1/jobs/{queueName}/active"
tags: ["Job Queue"]
---

# Retrieves active jobs in a queue

`GET /api/v1/jobs/{queueName}/active`

Fetches a paginated list of active jobs. Results can be paginated using query parameters.for the specified queue.

## Path parameters

- `queueName` string, required

## Query parameters

- `page` integer
- `pageSize` integer

## Response `200`

Successfully retrieved active jobs for the queue.

- ResponseEntityJobPaginatedResultView
  - `errors` ErrorEntity[]
    - `errorCode` string
    - `message` string
    - `fieldName` string
  - `entity` JobPaginatedResult
    - `total` integer
    - `page` integer
    - `pageSize` integer
    - `jobs` Job[]
      - `id` string
      - `queueName` string
      - `state` 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'FAILED_PERMANENTLY' | 'ABANDONED' | 'ABANDONED_PERMANENTLY' | 'CANCEL_REQUESTED' | 'CANCELLING' | 'CANCELED'
      - `executionNode` string
      - `createdAt` string, date-time
      - `startedAt` string, date-time
      - `updatedAt` string, date-time
      - `completedAt` string, date-time
      - `result` JobResult
        - `errorDetail` ErrorDetail
          - `message` string
          - `exceptionClass` string
          - `stackTrace` string
          - `timestamp` string, date-time
          - `processingStage` string
        - `metadata` object
      - `parameters` object
        - `empty` boolean
      - `retryCount` integer
      - `progress` number, float
  - `messages` MessageEntity[]
    - `message` string
  - `i18nMessagesMap` object
  - `permissions` string[]
  - `pagination` Pagination
    - `currentPage` integer
    - `perPage` integer
    - `totalEntries` integer

## Other responses

- `401` — Unauthorized: Invalid or missing user authentication.
- `403` — Forbidden: User does not have permission to view jobs in this queue.
- `404` — Not Found: Queue with the specified name does not exist.
- `500` — Internal Server Error: An unexpected error occurred while retrieving jobs.

---

[API](https://skmtc.dev/jostens/apis/dotcms-rest-api.md) · [All operations](https://skmtc.dev/jostens/apis/dotcms-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/jostens/dotcms-rest-api/revisions/a088fe9f515c/schema)
