---
title: "List the jobs of a sales order"
method: GET
path: "/sales_orders/{id}/jobs"
tags: ["Sales Orders", "Jobs"]
---

# List the jobs of a sales order

`GET /sales_orders/{id}/jobs`

## Request

- Base URL: `https://api.shopvox.com/v1`
- URL: `https://api.shopvox.com/v1/sales_orders/{id}/jobs`
- Auth: API key in query parameter `account_id` and API key in query parameter `authToken`

**Plan: Paid API.**

Returns all jobs of the active line items of the sales order in one response, in line
item order. The response has no pagination. Each job has the same fields as
`GET /jobs/{id}`. A job that more than one line item shares occurs one time. A voided
job is in the list with `active: false`.

## Response `200`

OK

- object
  - `jobs` JobWithSteps[]
    - `id` string, uuid
    - `tags` NamedRef[]: Active tags of the record.
      - `id` string, uuid
      - `name` string
    - `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.
- `404`: Not found.

## Changes

- **2026-11-10** `eb2f6524de94`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shopvox/apis/shopvox-public-api/changes/sales_orders/:id/jobs/get.md)

---

[API](https://skmtc.dev/shopvox/apis/shopvox-public-api.md) - [All operations](https://skmtc.dev/shopvox/apis/shopvox-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shopvox/apis/shopvox-public-api/revisions/66de040f44b3?raw)
