Stock API
The Stock API keeps the available quantity of your SKUs accurate on noon, so customers only ever see what you can actually fulfill. You push inventory changes as stock moves in your own systems, and noon updates what is sellable for each SKU. It is designed for sellers and ERP or inventory integrators who manage stock programmatically across large or fast-moving catalogs.
This page is an overview. To make your first API call, see the Stock API Quickstart.
What you can do
- Set the available quantity for a SKU to an exact value
- Update stock for many SKUs in a single bulk call
- Set stock to zero to immediately stop a SKU from selling
- Read the current quantity noon holds for your SKUs
- Keep noon in sync with your warehouse or ERP as inventory changes
Who should use this API
Use this API if:
- You manage your own inventory and need noon to reflect it programmatically
- You run scheduled or event-driven jobs that push stock changes at scale
- You sell fast-moving SKUs where keeping quantities current by hand is not practical
If you only need to adjust stock for a handful of SKUs occasionally, you can update quantities manually in the noon Partner Portal instead of integrating.
Key concepts
Available quantity — The number of sellable units noon can offer to customers for a SKU. This is what the Stock API sets.
Absolute updates — An update sets the available quantity to the value you send; it does not add to or subtract from the current quantity. Sending 25 makes the available quantity 25, regardless of what it was before.
Partner SKU — The identifier the stock is attached to. The SKU must already exist on noon before you can set its stock.
Warehouse — Stock is tracked per warehouse, identified by a warehouse_code from Seller Lab (set during FBPI warehouse setup). The same SKU can hold different quantities in different warehouses, and a partner can have several.
Reserved stock — Units held against in-flight customer orders. noon deducts these automatically and they are not set through this API.
Key operations
| Operation | What it does | Guide | Reference |
|---|---|---|---|
UpdateStock | Sets the available quantity for one or more SKUs | Stock API Quickstart | Reference |
GetStock | Returns the current available quantity noon holds for the given SKUs | — | Reference |
Next steps
- Stock API Quickstart — set the available quantity for a SKU and read the response
- UpdateStock API Reference — full request and response schema, including the Usage Plan (rate limits)
- GetStock API Reference — read current quantities for your SKUs