Inventory

Query stock and SKU allocations by location or SKU

Changed on

Provide at least one nonempty filter: locationIds or skuNumbers. When both are supplied, return their intersection. Both pagination fields are required.

Returns existing SKU-location associations only, including zero and negative stock; does not expand descendants.

post/api/inventory/stock/location/query

Request

  • Base URL
    https://api.desty.app
  • Auth
    none declared. Required headers: Authorization

Headers

Authorizationstring required

Authorization (Only:Bearer <access_token>)

Request body

externalWarehouseIdstring required

External warehouse ID returned by POST /api/warehouse/list. Storage must be activated for this warehouse.

skuNumbersstring[] nullable

Optional SKU filter, at most 200 entries. Unmatched SKU codes produce no rows.

pageNumberinteger required

Required page number, starting from 1. No default.

pageSizeinteger required

Required page size (1–200). No default.

Response

successful operation

codestring required

Business result code: "0" on success; otherwise INVALID_PARAMETER, INVALID_TOKEN, LIMIT_REQUEST or SERVER_ERROR.

msgstring nullable

Result message; normally null on success.

successboolean required

True when code equals "0".

Changes