O2M Logo
One to Many
Retrieve stock for a SKU
Was this page helpful?

Retrieve stock for a SKU

Get one item's stock by its SKU.

Overview

Returns the stock of one SKU. Use it to check one item; to read many, use List stock.

Request

GET/stock/{sku}

Needs the permission stock:read

cURL
curl "https://api.o2m.in/api/v1/stock/MUG-BLUE" \
  -H "X-Access-Key: $O2M_ACCESS_KEY" \
  -H "X-Secret-Key: $O2M_SECRET_KEY"
ParameterTypeRequiredDescription
skustringYesThe SKU, in the path. Encode any special characters.

Response

200 with one item, in the same shape as List stock.

Response
{
  "sku": "MUG-BLUE",
  "title": "Blue mug",
  "product_id": "MP-000123",
  "variant_id": null,
  "sellable": 15,
  "on_hand": 15,
  "available": 15,
  "committed": 0,
  "qc_hold": 0,
  "damaged": 0,
  "quarantine": 0,
  "reserved": 0,
  "incoming": 0,
  "in_transit": 0,
  "warehouses": [
    {
      "id": "1",
      "code": "DEFAULT",
      "name": "Default warehouse",
      "on_hand": 10,
      "available": 10,
      "committed": 0,
      "qc_hold": 0,
      "damaged": 0,
      "quarantine": 0,
      "reserved": 0,
      "incoming": 0,
      "in_transit": 0
    },
    {
      "id": "2",
      "code": "BLR",
      "name": "Bengaluru",
      "on_hand": 5,
      "available": 5,
      "committed": 0,
      "qc_hold": 0,
      "damaged": 0,
      "quarantine": 0,
      "reserved": 0,
      "incoming": 0,
      "in_transit": 0
    }
  ],
  "client": null,
  "updated_at": "2026-10-02T09:30:00.000Z"
}

Errors

StatusCodeMessageWhat to do
404—No item has SKU NOPECheck the SKU in O2M.

Every endpoint can also return the common errors: a missing or invalid key, a missing permission, the rate limit, or a temporary failure.