---
title: "List job outputs (flat or preview)"
method: GET
path: "/jobs/{jobId}/outputs"
tags: ["Manage Jobs"]
---

# List job outputs (flat or preview)

`GET /jobs/{jobId}/outputs`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/jobs/{jobId}/outputs`
- Auth: one of:
  - API key in query parameter `access_token`
  - HTTP bearer

Lists the outputs of a job, or a preview of the output groups with sets in paginated mode

## Path parameters

- `jobId` string, required

## Headers

- `X-Response-Mode` 'regular' | 'paginated'

## Response `200`

The job outputs (array or page wrapper when X-Response-Mode=paginated)

- union
  - union[]
    - union
      - DownloadUrl: Contains the download url for the datasets of a jobs.
        - `type` 'DownloadUrl', required: The type is "DownloadUrl"
        - `url` string: The presigned url for downloading the data.
        - `byteSize` number: The size of the data to be downloaded in bytes.
      - FeatureStatistics: Shows the statistics of the job.
        - `type` 'FeatureStatistics', required: The type is "FeatureStatistics"
        - `featureCount` number: The resultant feature count of the job.
        - `byteSize` number: The size of the data to be downloaded in bytes.
  - JobPayloads: Summary of grouped payloads (inputs/outputs) for a job.
    - `groups` object
    - `itemCount` number: Total items across all groups.
    - `byteSize` number: Total size of items across all groups in bytes.

## Other responses

- `400`: Malformed or Bad Request.
- `404`: Not found.

## Changes

- **2025-09-26** `b0f3c1c4fc93`: 2 breaking, 2 info
  - added `#/components/schemas/JobPayloads, subschema #1` to the response body `oneOf` list for the response status `200`
  - the response's body type changed from `array` to no type for status `200`
  - api operation id `getJobOutputs` removed and replaced with `getJobOutputPayloadsPreview`
  - added the new optional `header` request parameter `X-Response-Mode`
- **2024-05-21** `f590d51a45be`: 1 breaking, 1 warning, 2 info
  - the response's body type changed from no type to `array` for status `200`
  - deleted the `header` request parameter `X-Response-Mode`
  - api operation id `getJobOutputPayloadsPreview` removed and replaced with `getJobOutputs`
  - removed `#/components/schemas/JobPayloads, subschema #1` from the response body `oneOf` list for the response status `200`

[Operation history](https://skmtc.dev/here/apis/here-xyz-job-service/changes/jobs/:jobId/outputs/get.md)

---

[API](https://skmtc.dev/here/apis/here-xyz-job-service.md) - [All operations](https://skmtc.dev/here/apis/here-xyz-job-service/llms.txt) - [OpenAPI document](https://skmtc.dev/here/apis/here-xyz-job-service/revisions/88b5563c7e8b?raw)