---
title: "Get a job stock"
method: GET
path: "/v1/jobs/{jobId}/stock/{jobStockId}"
tags: ["Jobs"]
---

# Get a job stock

`GET /v1/jobs/{jobId}/stock/{jobStockId}`

Retrieve the details of a single job stock (required scope jobs:read)

## Path parameters

- `jobId` integer, required
- `jobStockId` integer, required

## Headers

- `Customer-Id` integer, required

## Response `200`

OK

- ReadJobStockModel — Represents a model that holds information about planned stock usage for a job
  - `id` integer — The unique identifier for each planned stock usage record
  - `jobId` integer — The identifier of the job associated with the planned stock usage
  - `stockDetailsId` integer — The identifier of the type of stock associated with the planned stock usage on the job
  - `stockItemId` integer, nullable — The identifier of the specific stock item associated with the planned stock usage on the job
  - `action` 'Unknown' | 'noMovement' | 'broughtAndLeft' | 'broughtAndTakenBack' | 'broughtToSwap' | 'onSiteAndTakenBack' | 'onSiteAndLeft' | 'usedInStock' — Represents the actions that can be performed on a job stock<p>Possible values:</p><ul><li><b>unknown</b>: Unknown action</li><li><b>noMovement</b>: No movement</li><li><b>broughtAndLeft</b>: Brought to job and left at location</li><li><b>broughtAndTakenBack</b>: Brought to job and taken back</li><li><b>broughtToSwap</b>: Brought to job to swap with other stock item</li><li><b>onSiteAndTakenBack</b>: Taken from job location</li><li><b>onSiteAndLeft</b>: Already on site and left at location</li><li><b>usedInStock</b>: Used on equipment</li></ul>
  - `quantityPlanned` number, double — The anticipated quantity of stock units that will be used on a job
  - `pickupContactId` integer, nullable — The identifier for the contact at the pickup location during the planned stock usage. If set, allowed actions are 'BroughtAndLeft', 'BroughtAndTakenBack' and 'UsedInStock'. Null value indicates that the stock will be on the vehicle relating to the job
  - `dropOffContactId` integer, nullable — The identifier for contact at the drop-off location during the planned stock usage. If set, allowed actions are 'BroughtAndTakenBack' and 'OnSiteAndTakenBack'. Null value indicates that the stock will be on the vehicle relating to the job
  - `isDeliveredToBeSold` boolean — A flag indicating whether the stock is delivered to be sold
  - `isEquipmentAtDropOff` boolean — A flag indicating whether the stock equipment is at the drop-off location
  - `quantityActual` number, double — The actual quantity of stock units that were used on a job
  - `make` string, nullable — Make of a stock item used in a job
  - `model` string — Model of a stock item used in a job. Usually used in conjunction with the Make for generic identification
  - `serialNumber` string, nullable — Used as a unique reference field for a stock item to track specific unit. Doesn't have to be set when a job is initialised
  - `dropOffStockItemId` integer, nullable — The identifier for the specific item of stock that is planned to be dropped at off or delivered to
  - `worksheets` ReadJobStockWorksheetModel[] — The worksheets associated with this stock item on the job. Each entry contains the worksheet identifier<br/>and the entity identifier to use as the `entityId` filter when querying worksheet answers<br/>with an `entityType` of `stockItem`
    - `worksheetId` integer — The identifier of the worksheet associated with the stock item on this job
    - `worksheetAnswersEntityId` integer — The entity identifier to use as the `entityId` filter when querying worksheet answers<br/>with an `entityType` of `stockItem`

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/bigchange/apis/bigchange-dx.md) · [All operations](https://skmtc.net/bigchange/apis/bigchange-dx/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigchange/bigchange-dx/revisions/916e669fc527/schema)