---
title: "Get a job"
method: GET
path: "/jobs/{id}"
tags: ["Jobs"]
---

# Get a job

`GET /jobs/{id}`

**Plan: Paid API.**

Returns the job plus a flattened `steps` summary array.

## Response `200`

OK

- object — A production job. `steps`/`lineItems` are present when applicable. The **list** endpoint (`GET /jobs`) returns a slightly different projection: it adds a nested `steps[]` array and an `installDate` field, and its `lineItems[]` omit `uom`. get-a-job and create return the shape documented here.
  - `id` string, uuid
  - `active` boolean
  - `name` string
  - `description` string, nullable
  - `workflowState` string, nullable
  - `companyId` string, uuid, nullable
  - `contactId` string, uuid, nullable
  - `assignedToId` string, uuid, nullable
  - `productionManagerId` string, uuid, nullable
  - `salesRepId` string, uuid, nullable
  - `jobTemplateId` string, uuid, nullable
  - `orderId` string, uuid, nullable
  - `orderLineItemId` string, uuid, nullable
  - `orderNumber` string, nullable
  - `lineNumber` integer, nullable
  - `projectNumber` string, nullable
  - `priority` string, nullable
  - `quantity` number, nullable
  - `requireProofing` boolean, nullable
  - `hasOrder` boolean
  - `daysLeft` integer, nullable
  - `dueDate` string, date, nullable
  - `dueTime` string, nullable
  - `dueDateFrom` string, nullable
  - `dueDateTo` string, nullable
  - `dueDateTimeFrom` string, nullable
  - `dueDateTimeTo` string, nullable
  - `currentStageId` string, uuid, nullable
  - `currentStageName` string, nullable
  - `currentStepId` string, uuid, nullable
  - `currentStepName` string, nullable
  - `bomDetails` string, nullable
  - `designDetails` string, nullable
  - `productionDetails` string, nullable
  - `shippingDetails` string, nullable
  - `installDetails` string, nullable
  - `lastEvent` string, nullable
  - `lastEventAt` string, date-time, nullable
  - `currentProofUrl` string, nullable
  - `currentProofThumbnailUrl` string, nullable
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `divisionId` string, uuid, nullable
  - `division` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string
  - `company` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string
  - `contact` NamedRef — Lightweight reference to a related record.
    - `id` string, uuid
    - `name` string
  - `salesRep` Party — A person reference (sales rep, PM, designer) with initials.
    - `id` string, uuid
    - `name` string, nullable
    - `initials` string, nullable
  - `productionManager` Party — A person reference (sales rep, PM, designer) with initials.
    - `id` string, uuid
    - `name` string, nullable
    - `initials` string, nullable
  - `assignedTo` Party — A person reference (sales rep, PM, designer) with initials.
    - `id` string, uuid
    - `name` string, nullable
    - `initials` string, nullable
  - `projectManager` Party — A person reference (sales rep, PM, designer) with initials.
    - `id` string, uuid
    - `name` string, nullable
    - `initials` string, nullable
  - `designer` Party — A person reference (sales rep, PM, designer) with initials.
    - `id` string, uuid
    - `name` string, nullable
    - `initials` string, nullable
  - `lineItems` object[]
    - `id` string, uuid
    - `lineNumber` integer, nullable
    - `position` integer
    - `name` string, nullable
    - `description` string, nullable
    - `quantity` number, nullable
    - `workflowState` string, nullable
    - `uom` string, nullable
  - `steps` object[]
    - `id` string, uuid
    - `name` string
    - `state` string
    - `assignedToName` string
    - `machineName` string
    - `estimatedTime` number, nullable

## Other responses

- `401` — Missing/expired credentials, an index request without a required filter, or the plan does not include this endpoint.

---

[API](https://skmtc.net/shopvox/apis/shopvox-public-api.md) · [All operations](https://skmtc.net/shopvox/apis/shopvox-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shopvox/shopvox-public-api/revisions/7ac1ff5d444a/schema)