Catalogus-API2026-11Preview
Voorraadniveaus
Hoeveel je van een variant nu kunt verkopen: de voorraad van de verkoper in China, plus wat je in ons magazijn hebt.
Niveaus veranderen als we een listing opnieuw lezen of als je schap verandert. Abonneer je op product.out_of_stock in plaats van te pollen.
Het Inventory level-object
variant, product, skustring- Wat het telt.
seller_in_stockboolean- Of de verkoper het kan verkopen, per checked_at.
seller_countinteger|null- Het eigen aantal van de verkoper, als de listing er een toont.
warehouse_on_handinteger- Stuks op ons schap die van jou zijn, gecontroleerd en gefotografeerd. Bestellingen worden eerst hieruit verzonden.
availableinteger- Wat je winkel toont: je schap plus het aantal van de verkoper, gemaximeerd op 100, omdat we op aanvraag kopen. 0 als de verkoper uitverkocht is en je schap leeg, of het product is gepauzeerd.
checked_atstring- Wanneer we de listing voor het laatst lazen.
{
"variant": "var_41hz",
"product": "prd_8f2k",
"sku": "5187209554",
"seller_in_stock": true,
"seller_count": 812,
"warehouse_on_hand": 24,
"available": 124,
"checked_at": "2026-11-04T09:12:40Z"
}Voorraadniveaus opvragen
GET/v1/inventory_levels
Elke variant die je verkoopt, of die van één product.
Scopeinventory:read
Queryparameters
productstring- Optioneel. Een product-id.
availablestring- Optioneel. zero voor de varianten die je winkel als uitverkocht toont.
limit, cursor- Pagination
curl "https://www.ninjabuy.com/api/v1/inventory_levels?product=prd_8f2k" \
-H "Authorization: Bearer $NINJABUY_API_KEY" \
-H "NinjaBuy-Version: 2026-11"HTTP/2 200 OK
{
"data": [
{
"variant": "var_41hz",
"product": "prd_8f2k",
"sku": "5187209554",
"seller_in_stock": true,
"seller_count": 812,
"warehouse_on_hand": 24,
"available": 124,
"checked_at": "2026-11-04T09:12:40Z"
},
{
"variant": "var_41j0",
"product": "prd_8f2k",
"sku": "5187209555",
"seller_in_stock": false,
"seller_count": 0,
"warehouse_on_hand": 0,
"available": 0,
"checked_at": "2026-11-04T09:12:40Z"
}
],
"has_more": false,
"cursor": null
}Het voorraadniveau van een variant ophalen
GET/v1/inventory_levels/{variant}
Eén variant, zoals laatst gelezen. Ophalen leest de marktplaats niet opnieuw.
Scopeinventory:read
Padparameters
variantstringverplicht- Een variant-id.
Fouten
| Status | Type | Wanneer |
|---|---|---|
| 404 | not-found | Deze variant bestaat niet op dit account. |
curl "https://www.ninjabuy.com/api/v1/inventory_levels/var_41hz" \
-H "Authorization: Bearer $NINJABUY_API_KEY" \
-H "NinjaBuy-Version: 2026-11"HTTP/2 200 OK
{
"variant": "var_41hz",
"product": "prd_8f2k",
"sku": "5187209554",
"seller_in_stock": true,
"seller_count": 812,
"warehouse_on_hand": 24,
"available": 124,
"checked_at": "2026-11-04T09:12:40Z"
}