---
title: "GET /stockUsed"
method: GET
path: "/stockUsed"
tags: ["Stock Used"]
---

# GET /stockUsed

`GET /stockUsed`

Returns historical stock used across all jobs, optionally filtered by filterDateFrom.
  
  Stock used is defined as material line items that:
  - Have been invoiced to the customer (sent or paid).
  - And are assigned as materials sales account.
  - And are not from purchase orders.
  - And are not invoiced from suppliers.

## Query parameters

- `filterDateFrom` string, date
- `pageCursor` string

## Response `200`

Successful Response

- StockUsedListResponse
  - `result` string, required
  - `data` StockUsedItem[], required
    - `productCode` string, nullable, required
    - `productName` string, required
    - `pricebookLineItemId` number, nullable, required
    - `pricebookId` number, nullable, required
    - `totalQty` number, required
  - `paging` Pagination
    - `perPage` number, required
    - `pageCount` number, required
    - `links` object, required
      - `self` string, required
      - `previous` string, nullable, required
      - `next` string, nullable, required

## Other responses

- `4XX` — Client Request Errors
- `5XX` — Server Errors

---

[API](https://skmtc.dev/fergus/apis/fergus-api.md) · [All operations](https://skmtc.dev/fergus/apis/fergus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fergus/fergus-api/revisions/b4f232a22363/schema)