BizKitHub
DocsAPI ReferenceWarehouse/bff/warehouse/product-stock
getWarehouseAdmin BFF

/bff/warehouse/product-stock

Returns total + per-warehouse + per-variant stock for a product. The Product detail "Stock" tab uses this as a single round-trip.

WarehousegetBffWarehouseProduct-stock

Parameters

2 query

Query parameters

· 2
productIdstringOptional

Numeric product id (alternative to productCode).

Exampleexample_productId
productCodestringOptional

Human-readable product code, e.g. from /bff/product/product-detail.

Exampleexample_productCode

Response schema

1 status code documented

200Success
productIdnumberRequired
productCodestringRequired
productNamestringRequired
productSkustring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
hasVariantsbooleanRequired
totalQuantitynumberRequired
totalReservednumberRequired
totalAvailablenumberRequired
perWarehouseobject[]Required
Each array item:
warehouseIdnumberRequired
warehouseCodestringRequired
warehouseNamestringRequired
quantitynumberRequired
quantityReservednumberRequired
availablenumberRequired
isDefaultbooleanRequired
variantsobject[]Required
Each array item:
variantIdnumberRequired
variantCodestringRequired
variantNamestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
totalQuantitynumberRequired
totalReservednumberRequired
totalAvailablenumberRequired
perWarehouseobject[]Required
Each array item:
warehouseIdnumberRequired
warehouseCodestringRequired
warehouseNamestringRequired
quantitynumberRequired
isDefaultbooleanRequired
lowStockWarningsobject[]Required
Each array item:
warehouseIdnumberRequired
warehouseNamestringRequired
variantIdnumber | nullRequired
One of 2:
Variant 1
number
Variant 2
null
variantNamestring | nullRequired
One of 2:
Variant 1
string
Variant 2
null
quantitynumberRequired
thresholdnumberRequired

Response example

application/json
{
  "productId": 0,
  "productCode": "example_productCode",
  "productName": "example_productName",
  "hasVariants": false,
  "totalQuantity": 0,
  "totalReserved": 0,
  "totalAvailable": 0,
  "perWarehouse": [
    {
      "warehouseId": 0,
      "warehouseCode": "example_warehouseCode",
      "warehouseName": "example_warehouseName",
      "quantity": 0,
      "quantityReserved": 0,
      "available": 0,
      "isDefault": false
    }
  ],
  "variants": [
    {
      "variantId": 0,
      "variantCode": "example_variantCode",
      "totalQuantity": 0,
      "totalReserved": 0,
      "totalAvailable": 0,
      "perWarehouse": [
        {
          "warehouseId": 0,
          "warehouseCode": "example_warehouseCode",
          "warehouseName": "example_warehouseName",
          "quantity": 0,
          "isDefault": false
        }
      ]
    }
  ],
  "lowStockWarnings": [
    {
      "warehouseId": 0,
      "warehouseName": "example_warehouseName",
      "quantity": 0,
      "threshold": 0
    }
  ]
}

Request example

GET /bff/warehouse/product-stock

get
curl -X GET "https://api.bizkithub.com/bff/warehouse/product-stock?productId=example_productId&productCode=example_productCode" \
  -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