---
title: "Get jobs"
method: GET
path: "/spaces/{spaceId}/jobs"
tags: ["Manage Jobs"]
---

# Get jobs

`GET /spaces/{spaceId}/jobs`

Retrieve jobs

## Path parameters

- `spaceId` string, required

## Query parameters

- `status` 'waiting' | 'queued' | 'validating' | 'preparing' | 'prepared' | 'executing' | 'executed' | 'finalizing' | 'finalized' | 'aborted' | 'failed'

## Response `200`

Job List

- Job[]
  - `type` string — The type of the job (deprecated)
  - `id` string — The unique identifier of the job. NOTE: The id will always be generated by the service. It can not be defined by the client.
  - `description` string — A human readable description of the purpose of the job
  - `source` DatasetDescription
    - `type` 'Space' | 'Spaces' | 'Files' — The type of the dataset
  - `target` DatasetDescription
    - `type` 'Space' | 'Spaces' | 'Files' — The type of the dataset

## Other responses

- `400` — Malformed or Bad Request.
- `401` — Unauthorized to perform the request.
- `403` — Forbidden request. Insufficient rights to perform the request.
- `404` — Not found.

## Changes

- **2025-07-30** `f6c73245e446` — 1 breaking
  - api path removed without deprecation
- **2025-01-08** `c39c865eea00` — 1 warning
  - removed the optional property `items/process` from the response with the `200` status
- **2025-01-08** `ac3f4744a9a9` — 1 breaking, 1 warning
  - the `items/process` response's property type changed from `object` to no type for status `200`
  - removed the optional property `items/process/type` from the response with the `200` status
- **2025-01-07** `03b55a5a94e5` — 1 info
  - added the optional property `items/process` to the response with the `200` status
- **2023-11-22** `bbe8fa8e63e9` — 1 warning, 2 info
  - removed the optional property `items/csvFormat` from the response with the `200` status
  - added the optional property `items/source` to the response with the `200` status
  - added the optional property `items/target` to the response with the `200` status

[Full history](https://skmtc.dev/here/apis/here-xyz-hub/changes/spaces/:spaceId/jobs/get.md)

---

[API](https://skmtc.dev/here/apis/here-xyz-hub.md) · [All operations](https://skmtc.dev/here/apis/here-xyz-hub/llms.txt) · [OpenAPI document](https://skmtc.dev/here/apis/here-xyz-hub/revisions/a5a97b4943e2?raw)