BizKitHub
DocsAPI ReferenceWarehouse/bff/warehouse/dashboard/health
getWarehouseAdmin BFF

/bff/warehouse/dashboard/health

One round-trip for the admin dashboard widget. Returns alert counts, dead-stock value, shrinkage rate, top movers, and reservation totals.

WarehousegetBffWarehouseDashboardHealth

Parameters

3 query

Query parameters

· 3
deadStockDaysstringOptional
Exampleexample_deadStockDays
shrinkageWindowDaysstringOptional
Exampleexample_shrinkageWindowDays
topMoversLimitstringOptional
Exampleexample_topMoversLimit

Response schema

1 status code documented

200Success
generatedAtstringRequired
totalActiveCellsnumberRequired
lowStockCountnumberRequired
reorderPointBreachCountnumberRequired
negativeAvailableCountnumberRequired
deadStockValuenumberRequired
deadStockCurrencystring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
shrinkageRatenumberRequired
totalReservedUnitsnumberRequired
activeSoftReservationsnumberRequired
topMoversobject[]Required
Each array item:
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
unitsMovednumberRequired

Response example

application/json
{
  "generatedAt": "example_generatedAt",
  "totalActiveCells": 0,
  "lowStockCount": 0,
  "reorderPointBreachCount": 0,
  "negativeAvailableCount": 0,
  "deadStockValue": 0,
  "shrinkageRate": 0,
  "totalReservedUnits": 0,
  "activeSoftReservations": 0,
  "topMovers": [
    {
      "itemLabel": "example_itemLabel",
      "unitsMoved": 0
    }
  ]
}

Request example

GET /bff/warehouse/dashboard/health

get
curl -X GET "https://api.bizkithub.com/bff/warehouse/dashboard/health?deadStockDays=example_deadStockDays&shrinkageWindowDays=example_shrinkageWindowDays&topMoversLimit=example_topMoversLimit" \
  -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