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

# List job inputs (flat or preview)

`GET /jobs/{jobId}/inputs`

## Request

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

Lists the available inputs of a job in flat mode, or a preview of the input groups with sets in paginated mode

## Path parameters

- `jobId` string, required

## Headers

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

## Response `200`

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

- union
  - UploadUrl[]
    - `type` 'UploadUrl', required: The type is "UploadUrl"
    - `s3Key` string: The type of the Input
    - `url` string: The presigned url for uploading the data.
  - 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 `getJobInputs` removed and replaced with `getJobInputPayloadsPreview`
  - 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 `getJobInputPayloadsPreview` removed and replaced with `getJobInputs`
  - 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/inputs/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)