---
title: "List inventory by SKU per warehouse"
method: GET
path: "/api/logistics/pvt/inventory/items/{skuId}/warehouses/{warehouseId}"
tags: ["Inventory"]
---

# List inventory by SKU per warehouse

`GET /api/logistics/pvt/inventory/items/{skuId}/warehouses/{warehouseId}`

## Request

- Base URL: `https://apiexamples.vtexcommercestable.com.br`
- URL: `https://apiexamples.vtexcommercestable.com.br/api/logistics/pvt/inventory/items/{skuId}/warehouses/{warehouseId}`
- Auth: one of:
  - API key in header `X-VTEX-API-AppKey` and API key in header `X-VTEX-API-AppToken`
  - API key in header `VtexIdclientAutCookie`

Lists [inventory](https://help.vtex.com/en/tutorial/inventory-management--tutorials_139) information, searching by [warehouse](https://help.vtex.com/en/tutorial/warehouse--6oIxvsVDTtGpO7y6zwhGpb) ID.

## Permissions

Any user or [API key](https://developers.vtex.com/docs/guides/api-authentication-using-api-keys) must have at least one of the appropriate [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3) to be able to successfully run this request. Otherwise they will receive a status code `403` error. These are the applicable resources for this endpoint:

| **Product** | **Category** | **Resource** |
| --------------- | ----------------- | ----------------- |
| Logistics | Logistics access | **Logistics full access** |
| Logistics | Logistics access | **Logistics viewer** |
| Logistics | Logistics access | **Logistics inventory full access** |
| Logistics | Logistics access | **Logistics inventory read only** |

You can [create a custom role](https://help.vtex.com/en/tutorial/roles--7HKK5Uau2H6wxE1rH5oRbc#creating-a-role) with that resource or use one of the following [predefined roles](https://help.vtex.com/en/tutorial/predefined-roles--jGDurZKJHvHJS13LnO7Dy):

| **Role** | **Resource** | 
| --------------- | ----------------- | 
| Logistics - Full access | Logistics full access |
| OMS - Full access | Logistics full access |
| Logistics - Full access | Logistics viewer |
| Logistics - Read only | Logistics viewer |
| Logistics - Full access | Logistics inventory full access |
| OMS - Full access | Logistics inventory full access |
| Logistics - Full access | Logistics inventory read only |
| Logistics - Read only | Logistics inventory read only |

>❗ Assigning a [predefined role](https://help.vtex.com/en/tutorial/predefined-roles--jGDurZKJHvHJS13LnO7Dy) to users or application keys usually grants permission to multiple [License Manager resources](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3). If some of these permissions are not necessary, consider creating a custom role instead. For more information regarding security, see [Best practices for using application keys](https://help.vtex.com/en/tutorial/best-practices-api-keys--7b6nD1VMHa49aI5brlOvJm). To learn more about machine authentication at VTEX, see [Authentication overview](https://developers.vtex.com/docs/guides/authentication).

## Path parameters

- `skuId` string, required
- `warehouseId` string, required

## Headers

- `Content-Type` string, required
- `Accept` string, required

## Response `200`

OK

- object[]
  - `skuId` string: SKU ID.
  - `warehouseId` string: Warehouse ID.
  - `dockId` string: Dock ID.
  - `totalQuantity` integer: Total quantity of SKU.
  - `reservedQuantity` integer: Reserved quantity of the SKU.
  - `availableQuantity` integer: Amount of items available for sale. Difference between total quantity and reserved quantity.
  - `isUnlimited` boolean: Indicates whether the SKU's availability is unlimited ("unlimited inventory").
  - `salesChannel` string[]: List of sales channels ([trade policies](https://help.vtex.com/en/tutorial/how-trade-policies-work--6Xef8PZiFm40kg2STrMkMV) associated.
  - `deliveryChannel` string[]: List of delivery channels available.
  - `timeToRefill` string: Time to refill.
  - `dateOfSupplyUtc` string: Date of supply lot in UTC.
  - `keepSellingAfterExpiration` boolean: Indicates whether SKU can continue to be sold after the available quantity gets to 0.
  - `transfer` string: Transfer.

---

[API](https://skmtc.dev/vtex/apis/logistics-api.md) - [All operations](https://skmtc.dev/vtex/apis/logistics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vtex/apis/logistics-api/revisions/dcb84d05d999?raw)