---
title: "Retrieve detailed inventory data"
method: GET
path: "/inventory"
tags: ["Inventory"]
---

# Retrieve detailed inventory data

`GET /inventory`

## Request

- Base URL: `https://api.zentail.com/v1`
- URL: `https://api.zentail.com/v1/inventory`
- Auth: API key in header `AUTHORIZATION`

Retrieve inventory data for SKUs with various filters. One of lastUpdatedTs, skus, warehouses is required to be passed in as a parameters.

## Query parameters

- `activeOnly` boolean
- `lastUpdatedTs` string
- `skus` string[]
- `isCaseSensitive` boolean
- `warehouses` integer[]
- `pageLength` integer
- `nextToken` string

## Response `200`

Success

- InventoryDetailsResponse
  - `results` Inventory[]
    - `SKU` string
    - `active` boolean
    - `standardProductId` string: Depending on the type defined in standardProductIdType this field contains either the UPC, EAN, ISBN, or GTIN for this product.
    - `standardProductIdType` string: One of UPC, EAN, ISBN or GTIN.
    - `totalAvailableQuantity` integer: This is the total quantity across all warehouses that is made available for sale on the marketplaces. This does not include stock committed or reserved for various sales orders.
    - `warehouses` WarehouseInventory[]
      - `warehouseName` string: The Name of the warehouse.
      - `warehouseUniqueId` string: Unique identifier for the warehouse as recognized by the application.
      - `availableQuantity` integer: This is the quantity from this warehouse that is made available for sale on the marketplaces. This does not include stock committed or reserved for various sales orders.
      - `assembledQuantity` integer, nullable: Inventory for Kits with assembled quantity.
      - `inventoryLocations` object[]: Bins are located within a warehouse.
        - `binLocation` string: Name of the Bin
        - `quantity` integer: Quantity in the Bin
      - `updatedTs` string, date-time: Timestamp quantity for this product in this warehouse was last updated.
      - `inboundShipments` WarehouseInventoryInboundShipments[]
        - `quantity` integer: This is the quantity that is inbound for this product in this warehouse.
        - `expectedDeliveryDate` string, date: This is the date the shipment is expected to arrive at the warehouse.
        - `tracking` string: Tracking for the shipment associated.
        - `carrier` string: Carrier for the shipment associated.
    - `lastInventoryUpdateTs` string, date-time: Timestamp quantity for this product was last updated across all warehouses.
  - `errors` string[]
  - `pagination` Pagination
    - `hasNext` boolean: Indicates if there is an additional page. This is `true` if there is another page, otherwise it is `false`.
    - `nextToken` string, uri: If `hasNext` is `true` this provides the full URL for the next page of results.

## Other responses

- `400`: Bad Request
- `403`: Permission Denied
- `404`: Not Found
- `500`: Zentail Error
- `503`: Zentail Error

---

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