BizKitHub
DocsAPI ReferenceWarehouse/bff/warehouse/alerts/low-stock
getWarehouseAdmin BFF

/bff/warehouse/alerts/low-stock

Same data the cron daemon scans. Ordered by severity (how far below the threshold). The dashboard surfaces the count as a notification badge; the warehouse list page renders the full list as a dedicated tab.

WarehousegetBffWarehouseAlertsLow-stock

Parameters

1 query

Query parameters

· 1
limitstringOptional
Exampleexample_limit

Response schema

1 status code documented

200Success
itemsobject[]Required
Each array item:
organisationIdnumberRequired
organisationNamestringRequired
stockItemIdnumberRequired
warehouseIdnumberRequired
warehouseNamestringRequired
productIdnumber | nullRequired
One of 2:
Variant 1
number
Variant 2
null
productCodestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
productNamestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
productVariantIdnumber | nullRequired
One of 2:
Variant 1
number
Variant 2
null
variantCodestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
variantNamestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
virtualItemSkustring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
itemLabelstringRequired
quantitynumberRequired
quantityReservednumberRequired
availablenumberRequired
thresholdnumberRequired
fromPolicybooleanRequired
reorderPointnumber | nullRequired
One of 2:
Variant 1
number
Variant 2
null
itemCountnumberRequired

Response example

application/json
{
  "items": [
    {
      "organisationId": 0,
      "organisationName": "example_organisationName",
      "stockItemId": 0,
      "warehouseId": 0,
      "warehouseName": "example_warehouseName",
      "itemLabel": "example_itemLabel",
      "quantity": 0,
      "quantityReserved": 0,
      "available": 0,
      "threshold": 0,
      "fromPolicy": false
    }
  ],
  "itemCount": 0
}

Request example

GET /bff/warehouse/alerts/low-stock

get
curl -X GET "https://api.bizkithub.com/bff/warehouse/alerts/low-stock?limit=example_limit" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key