---
title: "List publishing jobs"
method: GET
path: "/api/v1/publishing"
tags: ["Publishing"]
---

# List publishing jobs

`GET /api/v1/publishing`

Returns a paginated list of publishing jobs combining audit status and bundle metadata. Supports filtering by status and bundle name/ID. Each job includes asset preview (first 3 assets), environment count, and timing information.

## Query parameters

- `page` integer
- `per_page` integer
- `filter` string
- `status` string

## Response `200`

Publishing jobs retrieved successfully

- ResponseEntityPublishingJobsView
  - `errors` ErrorEntity[]
    - `errorCode` string
    - `message` string
    - `fieldName` string
  - `entity` PublishingJobView[]
    - `bundleId` string, required — Unique bundle identifier
    - `bundleName` string — Human-readable bundle name
    - `status` 'BUNDLE_REQUESTED' | 'BUNDLING' | 'SENDING_TO_ENDPOINTS' | 'FAILED_TO_SEND_TO_ALL_GROUPS' | 'FAILED_TO_SEND_TO_SOME_GROUPS' | 'FAILED_TO_BUNDLE' | 'FAILED_TO_SENT' | 'FAILED_TO_PUBLISH' | 'SUCCESS' | 'BUNDLE_SENT_SUCCESSFULLY' | 'RECEIVED_BUNDLE' | 'PUBLISHING_BUNDLE' | 'WAITING_FOR_PUBLISHING' | 'BUNDLE_SAVED_SUCCESSFULLY' | 'INVALID_TOKEN' | 'LICENSE_REQUIRED' | 'SUCCESS_WITH_WARNINGS' | 'FAILED_INTEGRITY_CHECK', required — Current publishing status
    - `filterName` string — Publishing filter name used
    - `filterKey` string — Publishing filter key identifier (use this for API calls)
    - `assetCount` integer, required — Total number of assets in the bundle
    - `assetPreview` AssetPreviewView[], required — Preview of first 3 assets in the bundle
      - `id` string, required — Asset identifier
      - `title` string, required — Human-readable asset title
      - `type` string, required — Asset type (e.g., contentlet, template, container, folder, host)
    - `environmentCount` integer, required — Number of target environments
    - `createDate` string, date-time, required — Bundle creation timestamp in ISO 8601 format
    - `statusUpdated` string, date-time — Last status update timestamp in ISO 8601 format
    - `numTries` integer, required — Number of publish attempts
  - `messages` MessageEntity[]
    - `message` string
  - `i18nMessagesMap` object
  - `permissions` string[]
  - `pagination` Pagination
    - `currentPage` integer
    - `perPage` integer
    - `totalEntries` integer

## Other responses

- `400` — Invalid request parameters (e.g., invalid status value, pagination out of range)
- `401` — Unauthorized - authentication required
- `403` — Forbidden - insufficient permissions

---

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