---
title: "Job"
description: "The processing of a firm order: queued by `createOrder`, made by the order worker five minutes later (at once for a test order), retried with a backoff of up to 30 minutes; above 100 cards it waits…"
canonical: "https://docs.printags.com/schemas/job/"
last_updated: "2026-11-16"
---

# Job

The processing of a firm order: queued by `createOrder`, made by the order worker five minutes later (at once for a test order), retried with a backoff of up to 30 minutes; above 100 cards it waits for the team's decision.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | string (uuid) | no |  |
| `type` | string | no |  |
| `status` | string: `pending`, `running`, `succeeded`, `failed` | no |  |
| `stage` | string: `queued`, `held_for_review`, `processing`, `manual_processing`, `done`, `failed` | no | Why the job has its status: `held_for_review` for an order above 100 cards waiting for the team, `manual_processing` when the team makes it by hand |
| `orderId` | string (uuid) | no |  |
| `location` | string | no | Where to poll this job |
| `retryAfter` | integer, nullable | no | Seconds before polling again; null once finished |
| `createdAt` | string (date-time) | no |  |
| `updatedAt` | string (date-time) | no |  |
| `result` | object, nullable | no | Once `succeeded`: the order, to read with `getOrder` |
| `result.orderId` | string (uuid) | no |  |
| `result.orderStatus` | string, nullable | no |  |
| `result.location` | string | no |  |
| `error` | object, nullable | no | Once `failed` |
| `error.code` | string | no |  |
| `error.message` | string | no |  |

## Example

```json
{
  "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"
  }
}
```
