---
title: "List BackgroundJobs"
method: GET
path: "/api/v2/ui/backgroundJobs"
tags: ["BackgroundJobs"]
---

# List BackgroundJobs

`GET /api/v2/ui/backgroundJobs`

## Request

- Base URL: `https://docs.hashtopolis.org`
- URL: `https://docs.hashtopolis.org/api/v2/ui/backgroundJobs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hashtopolis/apis/hashtopolis-api/docs/api/v2/ui/backgroundJobs/get.ts> (a function with typed inputs; its response is checked against the schema)

GET many request to retrieve multiple objects.

## Query parameters

- `page[after]` string
- `page[before]` string
- `page[size]` integer
- `filter` object
- `include` string[]

## Response `200`

successful operation

- BackgroundJobListResponse
  - `jsonapi` object, required
    - `version` string, required
    - `ext` string[]
  - `links` object, required
    - `self` string, required
    - `first` string, required
    - `last` string, nullable, required
    - `next` string, nullable, required
    - `prev` string, nullable, required
  - `meta` object, required
    - `page` object, required
      - `total_elements` integer, required
  - `data` object[], required
    - `id` integer, required
    - `type` 'backgroundJob', required
    - `attributes` object, required
      - `jobType` string, required
      - `payload` object, required
      - `status` union, required
        - -1
        - 0
        - 1
        - 2
      - `userId` integer, nullable, required
      - `createdAt` integer, required
      - `startedAt` integer, nullable, required
      - `finishedAt` integer, nullable, required
      - `exitCode` integer, nullable, required
      - `resultMessage` string, nullable, required
    - `links` object, required
      - `self` string, required
    - `relationships` object, required
      - `user` object, required
        - `links` object, required
          - `self` string, required
          - `related` string, required
        - `data` object, nullable
          - `type` 'user', required
          - `id` integer, required
  - `included` object[]
    - `id` integer, required
    - `type` 'user', required
    - `attributes` object, required
      - `name` string, required
      - `email` string
      - `isValid` boolean
      - `isComputedPassword` boolean
      - `lastLoginDate` integer
      - `registeredSince` integer
      - `sessionLifetime` integer
      - `globalPermissionGroupId` integer

## Other responses

- `400`: Invalid request
- `401`: Authentication failed
- `403`: Permission denied

## Changes

- **2026-11-06** `87f3bd43387f`: 2 breaking, 1 warning, 2 info
  - added the pattern `^[A-Za-z0-9+/]*={0,2}$` to the `query` request parameter `page[after]`
  - added the pattern `^[A-Za-z0-9+/]*={0,2}$` to the `query` request parameter `page[before]`
  - for the `query` request parameter `page[size]`, the min was set to `1.00`
  - for the `query` request parameter `page[after]`, the format was generalized from `byte` to no format
  - …1 more
- **2026-10-22** `559b0274a0c8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hashtopolis/apis/hashtopolis-api/changes/api/v2/ui/backgroundJobs/get.md)

---

[API](https://skmtc.dev/hashtopolis/apis/hashtopolis-api.md) - [All operations](https://skmtc.dev/hashtopolis/apis/hashtopolis-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hashtopolis/apis/hashtopolis-api/revisions/87f3bd43387f?raw)