Get

[POST] .../v1/itemstocklimit/get

Returns stock-specific item quantity limits. Use this method to read item minimum and maximum quantity limits configured for specific warehouses. The response returns paged ItemStockLimit records and supports filters by id, item_id, stock_id, min_quantity and max_quantity; stock filtering is additionally restricted by the current user's warehouse access. Item/GetExt returns these stock-specific values directly in item.min_quantity and item.max_quantity when the request selects exactly one accessible stock_id; otherwise it returns the item's global limits. This method requires billing db version 404 or later; older account databases return ErrorResult 1008. The caller must have item select permission; requested warehouses outside the current user's access are excluded from the result; missing request body, invalid filters and persistent storage errors are returned as HTTP 200 ErrorResult.

Request Parameters

Name	Type	Required	Description
filters	Array of Filter	Optional	Optional filters by fields available for this API method.
limit	Int32	Optional	Maximum number of returned limits.
offset	Int32	Optional	Offset from the beginning of the result set.

Filterable Fields

Field	Type	Description
id	int	Limit record IDs.
item_id	int	Item IDs.
max_quantity	decimal
min_quantity	decimal
stock_id	int	Stock IDs.

Request Example

{
  "filters": [
    {
      "Field": "item_id",
      "Operator": "In",
      "Value": "1001,1002"
    },
    {
      "Field": "stock_id",
      "Operator": "Equal",
      "Value": "3"
    }
  ],
  "limit": 20,
  "offset": 0
}

Response Parameters

Name	Type	Description
next_offset	Int32	Offset for the next data page.
ok	Boolean	Indicates whether the request completed successfully.
result	Array of ItemStockLimit	Result array.
total	Int64	Total number of result items.

Response Example

{
  "ok": true,
  "result": [
    {
      "id": 501,
      "item_id": 1001,
      "stock": {
        "id": 3,
        "name": "Main warehouse",
        "address": "Tashkent",
        "description": "Retail stock",
        "area": 120.5,
        "deleted_mark": false,
        "firm": {
          "id": 1,
          "name": "REGOS",
          "fullname": "REGOS LLC",
          "boss_name": "Director",
          "address": "Tashkent",
          "phones": "\u002B998901234567",
          "description": "Main company",
          "inn": "123456789",
          "bank_name": "Bank",
          "mfo": "00444",
          "rs": "20208000123456789001",
          "oked": "62010",
          "vat_index": "123456789012",
          "deleted_mark": false,
          "group": {
            "id": 1,
            "name": "Default",
            "parent_id": 0,
            "last_update": 1721894400
          },
          "last_update": 1721894400
        },
        "last_update": 1721894400
      },
      "min_quantity": 12.5,
      "max_quantity": 120.0,
      "last_update": 1721894400
    }
  ],
  "next_offset": 0,
  "total": 1
}