# Stock

**GET** `/v1/inventory/stock`

Returns total stock quantities per listing per location. This is the aggregate view — the sum of all batches at each location. For per-batch breakdown use `GET /v1/inventory/batches`.

### Query parameters

| Field | Type | Description |
|---|---|---|
| `listing_id` | integer | Filter to a specific listing |
| `location_id` | integer | Filter to a specific location |

### Response fields

| Field | Type | Description |
|---|---|---|
| `stock` | array | List of stock records |

**Stock record**

| Field | Type | Description |
|---|---|---|
| `id` | integer | Stock record ID |
| `listing_id` | integer | Listing ID |
| `location_id` | integer | Location ID |
| `quantity` | integer | Total units currently at this location (all batches combined) |
| `reorder_point` | integer | Low-stock threshold (nullable) — see `GET /v1/inventory/low-stock` |
| `listing` | object | Associated listing (`id`, `sku`, `barcode`) |
| `location` | object | Associated location (`id`, `name`, `code`) |