# Retrieve data for publishing job filters

Returns data to populate filters for publishing jobs. Returned data is  dynamic and depends on the filters already selected. This operation finds all publishing jobs that match the selected filters and returns distinct values for the `source`, `system.createdBy`, and `system.status` fields of these jobs.
To retrieve publishing jobs that match the selected filters, your token must include one of the following scopes `xmcpub.jobs.a:r`, `xmcpub.jobs.t:r`, or `xmcpub.jobs.t:rl`.

Endpoint: GET /authoring/publishing/v1/jobs/filters
Version: v1.0
Security: Bearer

## Security:

  - `Bearer` (unknown)
    http bearer JWT

## Query parameters:

  - `source` (array)
    The source value to use when filtering jobs. Use a pipe to specify multiple values (for example, `?source=Pages|Sites`). Wildcards are not supported.

  - `system.createdBy.id` (array)
    The ID of the creator to use when filtering jobs. Use a pipe to specify multiple values (for example, `?system.createdBy.id=Qbu3QmWtnQoU0my5jX9MFxBYIeQrFhd2|auth0|000b2fc5fa6b9e5883b6245b`). Wildcards are not supported.

  - `system.createdBy.name` (array)
    The name of the creator to use when filtering jobs. Use a pipe to specify multiple values (for example, `?system.createdBy.name=John+Doe|John+Smith`). Wildcards are not supported.

  - `system.status` (array)
    The status value to use when filtering jobs. Use a pipe to specify multiple values (for example, `?system.status=Queued|Running`).

  - `system.queuedTime` (array)
    The job queued time to filter entries by. Use `&` to include more than one filter (for example, `?system.queuedTime=>2024-10-14T00:00:00.000Z&system.queuedTime=<2024-12-31T00:00:00.000Z`). Only `=>DATE` and `=<DATE` filters are supported.

  - `system.startTime` (array)
    The job start time to filter entries by. Use `&` to include more than one filter (for example, `?system.startTime=>2024-10-14T00:00:00.000Z&system.startTime=<2024-12-31T00:00:00.000Z`). Only `=>DATE` and `=<DATE` filters are supported.

  - `system.finishTime` (array)
    The job finish time to filter entries by. Use `&` to include more than one filter (for example, `?system.finishTime=>2024-10-14T00:00:00.000Z&system.finishTime=<2024-12-31T00:00:00.000Z`. Only `=>DATE` and `=<DATE` filters are supported.

## Response 200:

  - `200` (unknown)
    Job filters successfully retrieved

## Response 200 fields (application/json):

  - `statuses` (array, required)
    The available statuses for filtering.

  - `statuses.data` (object, required)
    The publish job status data.

  - `statuses.data.status` (string, required)
    The job status.
    Enum: "Queued", "Running", "Completed", "Failed", "Canceled", "Canceling"

  - `sources` (array, required)
    The unique list of available sources.

  - `sources.data` (object, required)
    The source data.

  - `sources.data.source` (string, required)
    The source value.

  - `createdBy` (array, required)
    The unique list of jobs creators.

  - `createdBy.data` (object, required)
    Represents the data for the user who created the job.

  - `createdBy.data.id` (string, required)
    The ID of the creator.

  - `createdBy.data.name` (string, required)
    The name of the creator.

  - `createdBy.data.type` (string, required)
    The type of the creator.
    Enum: "Application", "User"

## Response 400:

  - `400` (unknown)
    Invalid parameters in request query string

## Response 400 fields (application/json):

  - `type` (string)

  - `title` (string)

  - `status` (integer)

  - `detail` (string)

  - `instance` (string)

## Response 401:

  - `401` (unknown)
    Unauthorized request or invalid access token

## Response 401 fields (application/json):

  - `type` (string)

  - `title` (string)

  - `status` (integer)

  - `detail` (string)

  - `instance` (string)

## Response 403:

  - `403` (unknown)
    Forbidden. Possible reasons:
  - Authorization failed (required scopes and/or roles are missing)
  - Context tenant cannot be resolved from the access token

## Response 403 fields (application/json):

  - `type` (string)

  - `title` (string)

  - `status` (integer)

  - `detail` (string)

  - `instance` (string)