---
title: "SearchBinracks"
method: POST
path: "/api/Stock/SearchBinracks"
tags: ["Stock"]
---

# SearchBinracks

`POST /api/Stock/SearchBinracks`

Finds all binracks where an item can be placed. Filters out the result by group and binrack restrictions for a particular stock item.
List of BinRack Type Ids which should be searched can be supplied for a particular location, if null all binracktypes will be considered. You can get the list from Get Stock/GetBinrackTypes
The response will be ordered by where the system thinks the item should be moved. The logic is determined by one of the default behaviours of the system or by custom configuration of the warehouse stock flow
<b>Permissions Required: </b> GlobalPermissions.Inventory.WarehouseManagementNode
<b>Rate limit: </b><span style="background-color:#0272d9;color:white;padding:4px 8px;text-align:center;border-radius:5px; font-size: small;"><b>150</b></span> / minute

## Request body

- StockSearchBinracksRequest
  - `request` SearchBinracksRequest
    - `BinRack` string — Bin rack search term. For example for PUT1.2.3878, bin rack search term PUT1 will yeild the result
    - `LocationId` string, uuid — Specific location id. Location must be Warehouse Managed location
    - `StockItemId` string, uuid — Stock Item Id
    - `BinRackTypeIds` integer[] — List of types of bin racks, nullable. If not provided all binrack types will be searched
    - `PageNumber` integer

## Response `200`

OK

- BinracksResponse
  - `BinRacks` WarehouseBinRack[] — List of binracks available for the given item in the order applicability.
    - `BinRackId` integer — BinRack internal id
    - `BinRackTypeId` integer — BinRack type id
    - `BinRack` string — BinRack
    - `GeoPosition` GeoPosition — Describes GeoPosition
      - `X` number, double — X position
      - `Y` number, double — Y position
      - `Z` number, double — Z position
    - `Dimension` Dimension — Dimension
      - `Width` number, double — Width
      - `Depth` number, double — Depth
      - `Height` number, double — Height
    - `RoutingSequence` integer — Sequence in which the picking or stock movement should be done. Routing.
    - `MaxCapacityVolumetric` number, double — Max capacity volume
    - `CurrentFullPercentage` number, double — Maximum volumetric capacity of the location WxDxH = volumetric
    - `MaxQuantityCapacity` integer — How full the bin rack is in percentage 0 to 100, based on the max quantity or max volumetric capacity. Updated everytime stock is moved in or out.
    - `CurrentQuantity` integer — Current total quantity of all items in the bin rack. Updated everytime stock is moved in or out.
    - `CurrentVolumetric` number, double — Current calculation of total volumetric total for all items in the binrack. Updated everytime stock is moved in or out.
    - `OptimalReplenishFullPercentage` number, double — Based on the fill percentage, indicates the bin rack as needs replenishment. Auto recalculated based on the consumption.
    - `CriticalReplenishFullPercentage` number, double — User fixed fill percentage. When it reaches this level the binrack is considered for replenishment.
    - `ItemRestriction` boolean — Item Restriction
    - `GroupRestriction` boolean — Group Restriction
    - `LocationId` string, uuid — Location of the binrack.
    - `TypeName` string — Readonly value of the TypeName loaded from BinRackTypeId
    - `StandardType` integer — Readonly value of the Standard type loaded from BinRackTypeId
    - `IsVolumetric` boolean — Readonly value indicates if the Type is Volumumetric
    - `AccessOrientation` string — Direction the item should be accessed from.
    - `StorageGroups` string[] — List of storage groups either for the whole binrack or relevant to specific stock item.
    - `UniqueSkus` integer — Unique skus in binrack.
    - `ItemsInfo` WarehouseBinRackItemsInfo
      - `BinRackId` integer
      - `NumberOfItems` integer
      - `TotalQuantity` integer
    - `BinrackType` WarehouseBinRackType — Bin Rack Type
      - `BinRackTypeId` integer — Binrack type id - unique record identifier
      - `Name` string — Custom name for bin rack type
      - `StandardType` integer — Binrack Standard Type Id 1 - Picking 2 - Special Access Picking 3 - Storage 4 - Deep Storage 5 - Putaway 6 - Quality Assurance 7 - Scrap / Quarantine 8 - Returns 0 - Flexible
      - `LocationBound` string, uuid — Identifies whether the bin rack type is bound to a specific location
      - `IsVolumetric` boolean — Is type restricted to volumetric measurements only
      - `DefaultBatchStatus` 'Unchanged' | 'Available' | 'Restricted' — Sets the default status for batches in this binrack type
    - `IsValidForStockItem` boolean — Indicates if the binrack is valid for the supplied stockitem.
  - `Decisions` string[]

---

[API](https://skmtc.net/linnworks/apis/authenticate-api.md) · [All operations](https://skmtc.net/linnworks/apis/authenticate-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/linnworks/authenticate-api/revisions/0123569a22fb/schema)