---
title: "Get the job of a firm order"
description: "Polls the job that `createOrder` with `Prefer: respond-async` pointed at (its `Location`)."
canonical: "https://docs.printags.com/get-the-job-of-a-firm-order/"
last_updated: "2026-11-16"
---

# Get the job of a firm order

`GET /v2/accounts/{accountId}/jobs/{jobId}`

Polls the job that `createOrder` with `Prefer: respond-async` pointed at (its `Location`). `status` is `pending` or `running` while the order is processed (poll again after `Retry-After` seconds), then `succeeded` with `result` (the order to read with `getOrder`) or `failed` with `error`. A job is only readable by the account that created its order, and in its key's mode (test or live).

## Authentication

An API key as a Bearer token: `Authorization: Bearer <key>`. A `sk_test_` key creates and sees test orders only. Keys and test mode: [overview](/).

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `accountId` | path | string | yes | Unique identifier of the account, or the alias `@me` for the account authenticated by the token. |
| `jobId` | path | string (uuid) | yes | The `job.id` of the 202 answer |

## Responses

| Status | Description |
| --- | --- |
| 200 | The job |
| 401 | Unauthorized, authentication required, or an OAuth access token unknown, expired or revoked (`INVALID_TOKEN`) |
| 403 | The API key is inactive or revoked (`INACTIVE_API_KEY`); with an OAuth access token: a token of scope `mcp` (`INSUFFICIENT_SCOPE`), a path naming another account or a person no longer a member of it (`ACCOUNT_ACCESS_DENIED`), a real token on the sandbox host (`SANDBOX_REQUIRES_TEST_KEY`) |
| 404 | No job of this id for the authenticated account and mode (`JOB_NOT_FOUND`) |
| 500 | Internal server error |

### 200 response

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `success` | boolean | no |  |
| `job` | [Job](/schemas/job/) | no |  |

```json
{
  "success": true,
  "job": {
    "id": "0b6f1c9e-3c1a-4e57-9f5e-6a2d8f1b7c40",
    "type": "order.treatment",
    "status": "pending",
    "stage": "queued",
    "orderId": "7b1e2a4c-0000-4000-8000-000000000000",
    "location": "/v2/accounts/@me/jobs/0b6f1c9e-3c1a-4e57-9f5e-6a2d8f1b7c40",
    "retryAfter": 300,
    "result": {
      "orderStatus": "validated",
      "location": "/v2/accounts/@me/orders/7b1e2a4c-0000-4000-8000-000000000000"
    },
    "error": {
      "code": "ORDER_PROCESSING_FAILED"
    }
  }
}
```

## Example

```bash
curl -X GET "https://api.printags.com/v2/accounts/@me/jobs/{jobId}" \
  -H "Authorization: Bearer $PRINTAGS_API_KEY"
```
