Retrieve a bin

Operation ID: getBin

Group: Inventory › Bins

Open in the interactive reference

GET /inventory/bins/{id}

Read-only: Reads and returns; changes nothing.

Retrieves a bin. Use the bin's id, not its binCode.

The bin comes back with its layout, limits, and settings, and with capacity. capacity is what the bin contains now, measured against the bin's limits. For a bin with no limits, capacity reports zero contents, whatever the bin contains.

Only this endpoint returns capacity. The collection GET inventory/bins and POST inventory/bins/search do not.

Parameters

Name In Type Required Description
Api-Version header string · v1 yes The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version v1.
id path string yes The unique identifier of the bin you want to retrieve.

Response

200 Success

Under data (getBinOutput):

Field Type Required Description
id string yes The unique identifier for the bin. Example: "8e1c40a7-5b93-4d26-a0f8-3c74e19b5d02".
binCode string no The short code that identifies the bin, for example 'A-01-1'. It is unique within the tenant, not per warehouse, and cannot be changed after the bin is created. Example: "A-01-1".
barcode string no The barcode printed on the bin label. It is unique within the tenant and cannot be changed after the bin is created. Example: "BIN-A011".
locationId string no The unique identifier for the warehouse the bin is in. It cannot be changed after the bin is created. See id on GET inventory/warehouses/:id. Example: "f5272ae0-0f0b-47d2-b78a-2158fec2cc32".
locationCode string no The code of that warehouse. Example: "WH-02".
locationName string no The name of that warehouse. Example: "Main warehouse".
aisle string no The aisle in the warehouse layout. Example: "A".
rack string no The rack within the aisle. Example: "01".
shelfLevel string no The shelf level within the rack. Example: "1".
zone string no The logical zone of the bin, as your tenant names them. For example 'Picking', 'Storage' or 'Quarantine'. Example: "Picking".
itemPosition string no The position within the shelf, where a bin is subdivided further.
isPickingBin boolean no Whether the bin is a picking location, a fast-access place stock is taken from to fulfill shipments. Example: true.
isReceivingBin boolean no Whether the bin stages newly received goods before they are put away. Example: false.
isProductionBin boolean no Whether the bin feeds or receives production.
maxQuantity number no The largest number of units the bin will hold. It is meaningful only when everything in the bin is counted in the same unit. Example: 500.
maxWeight decimal no The largest weight the bin will hold, in maxWeightUnit. Example: "250".
maxWeightUnit string no The unit maxWeight is given in. Possible values: 'G', 'Kg', 'Lbs'. Example: "Kg".
maxVolume decimal no The largest volume the bin will hold, in maxVolumeUnit.
maxVolumeUnit string no The unit maxVolume is given in. Possible values: 'L'.
capacityCheckMode string no What happens when a movement would exceed a limit. Possible values: 'HardBlock', which refuses the movement, and 'SoftWarning', which allows it and flags it. Example: "HardBlock".
tempZone string no The temperature zone the bin belongs to, as your tenant names them. For example 'Ambient', 'Chilled' or 'Frozen'. Example: "Ambient".
tempMin decimal no The lowest temperature kept in the bin, in degrees Celsius.
tempMax decimal no The highest temperature kept in the bin, in degrees Celsius.
supportsPerishable boolean no Whether perishable stock may be kept in the bin. Example: false.
active boolean no Whether the bin may be chosen for new movements. When false, the stock already in the bin stays there but no new movement can be assigned to it. Example: true.
createdDate date-time no The date and time the bin was created, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ.
lastModifiedDate date-time no The date and time the bin record last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ. Example: "2026-08-18T09:14:22.517Z".
capacity object no What is in the bin now, measured against what it will hold. Present on this endpoint only. Absent when the bin has no limit configured, because there is nothing to measure a utilization against. Example: {"currentQuantity":"310","currentWeight":"148.2","quantityUtilizationPct":"62","weightUtilizationPct":"59.3","status":"ok","mixedUnits":false}.
capacity.currentQuantity decimal no The number of units in the bin.
capacity.currentWeight decimal no The total weight of what is in the bin, normalized to kilograms whatever unit the limit is given in.
capacity.currentVolume decimal no The total volume of what is in the bin, normalized to cubic meters.
capacity.quantityUtilizationPct decimal no How full the bin is against maxQuantity, as a percentage.
capacity.weightUtilizationPct decimal no How full the bin is against maxWeight, as a percentage.
capacity.volumeUtilizationPct decimal no How full the bin is against maxVolume, as a percentage.
capacity.status string no How full the bin is overall. Possible values: 'ok', 'near_full', 'exceeded'. 'exceeded' means the bin is over a limit it was given, which is possible because a 'SoftWarning' bin allows the movement that crosses the limit.
capacity.mixedUnits boolean no Whether the bin holds items counted in more than one stocking unit. When true, currentQuantity is a sum of unlike things and the quantity utilization means nothing, so use the weight and volume instead. 
{
  "data": {
    "id": "8e1c40a7-5b93-4d26-a0f8-3c74e19b5d02",
    "binCode": "A-01-1",
    "barcode": "BIN-A011",
    "locationId": "f5272ae0-0f0b-47d2-b78a-2158fec2cc32",
    "locationCode": "WH-02",
    "locationName": "Main warehouse",
    "aisle": "A",
    "rack": "01",
    "shelfLevel": "1",
    "zone": "Picking",
    "itemPosition": "<itemPosition>",
    "isPickingBin": true,
    "isReceivingBin": false,
    "isProductionBin": true,
    "maxQuantity": 500,
    "maxWeight": "250",
    "maxWeightUnit": "Kg",
    "maxVolume": "19.99",
    "maxVolumeUnit": "<maxVolumeUnit>",
    "capacityCheckMode": "HardBlock",
    "tempZone": "Ambient",
    "tempMin": "19.99",
    "tempMax": "19.99",
    "supportsPerishable": false,
    "active": true,
    "createdDate": "2026-01-15T09:30:00.000Z",
    "lastModifiedDate": "2026-08-18T09:14:22.517Z",
    "capacity": {
      "currentQuantity": "310",
      "currentWeight": "148.2",
      "quantityUtilizationPct": "62",
      "weightUtilizationPct": "59.3",
      "status": "ok",
      "mixedUnits": false
    }
  },
  "diagnostics": [
    {
      "code": "<code>",
      "message": "<message>",
      "severity": "error",
      "path": [
        "<path>"
      ],
      "details": "<details>"
    }
  ]
}

Errors

Code Status
NOT_FOUND 400

Statuses