---
title: "Query Stocks Per Item"
method: GET
path: "/v2/stocks"
tags: ["stock"]
---

# Query Stocks Per Item

`GET /v2/stocks`

Query stocks for a specific item, warehouse or storage location

## Query parameters

- `itemId` string, uuid
- `warehouseId` string, uuid
- `storageLocationId` string, uuid
- `pageNumber` integer
- `pageSize` integer

## Headers

- `x-tenant-id` string, uuid, required
- `x-runas` string
- `x-companyid` string

## Response `200`

The requested stock information.

- JTLWawiRestContractsModelsPagedListOfJTLWawiRestContractsModelsV1StockStock — Represents a paginated list of items
  - `totalItems` integer — Gets or sets the total number of items available in the data source.
  - `pageNumber` integer — Gets or sets the current page number in the paginated list.
  - `pageSize` integer — Gets or sets the number of items per page in the paginated list.
  - `items` JTLWawiRestContractsModelsV1StockStock[] — Gets or sets the collection of items contained in the paged list.
    - `warehouseId` string, uuid
    - `storageLocationId` string, uuid
    - `storageLocationName` string — Name of the storage location.
    - `itemId` string, uuid
    - `shelfLifeExpirationDate` string, date-time — Shelf life expiration date of the item, if applicable.
    - `batchNumber` string — Batch number of the item if, the item is a batch item.
    - `quantityTotal` number — Total quantity of this item at this storage location.
    - `quantityLockedForShipment` number — Quantity at this storage location that is locked for shipment, f.e. because the storage location or warehouse is locked for shipment.
    - `quantityLockedForAvailability` number — Quantity at this storage location that is locked for availability, f.e. because the storage location or warehouse is locked for availability.
    - `quantityInPickingLists` number — Quantity at this storage location that is on picking lists.
  - `totalPages` integer — Gets the total number of pages based on the total number of items and the page size.
  - `hasPreviousPage` boolean — Gets a value indicating whether there is a previous page available in the paginated list.
  - `hasNextPage` boolean — Gets a value indicating whether there is a next page available.
  - `nextPageNumber` integer — Gets the number of the next page if there is one; otherwise, returns the total number of pages.
  - `previousPageNumber` integer — Gets the number of the previous page. If there is no previous page, it returns 1.

## Other responses

- `401`
- `402` — No licence available or the app has not been authorised by JTL.
- `404` — No fields could be found.

---

[API](https://skmtc.net/jtl-software/apis/scx-authentication-api.md) · [All operations](https://skmtc.net/jtl-software/apis/scx-authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jtl-software/scx-authentication-api/revisions/f979b1ea6951/schema)