---
title: "Get prompt jobs."
method: GET
path: "/prompt_jobs/{id}"
tags: ["Prompt Job"]
---

# Get prompt jobs.

`GET /prompt_jobs/{id}`

Called by the Independent Software Vendor. Lists the prompt job in the database for provided id.

## Path parameters

- `id` integer, required

## Headers

- `Authorization` string, api_id:api_token, required
- `Accept` string, required

## Response `200`

Success

- object
  - `id` integer — Unique identifier of the prompt job (returned when the prompt job was created).
  - `type` string — The type of the prompt job. Allowed values - `"yes/no"`, `"ok/cancel"`, `"signature"`
  - `result` string — Contains either the action that the user took ("yes", "no", "ok", "cancel") or the signature file encoded in base64.
  - `status` string — Status of the returned prompt job. Allowed values - `"in progress"`, `"finalized"`, `'error'`, `"timed out"`, `'canceled'`
  - `remote_id` string — Used for keeping track of a 3rd party identifier alongside the prompt job. Size range - `0..100`
  - `v` string — The API version that was used to handle the request.

## Other responses

- `4XX` — Possible errors - 1, 17, 189

---

[API](https://skmtc.net/bankofamerica/apis/transaction-broker-api.md) · [All operations](https://skmtc.net/bankofamerica/apis/transaction-broker-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bankofamerica/transaction-broker-api/revisions/6097bc689e41/schema)