ListInventory returns what Zentail currently believes about the SKUs stocked in the caller's warehouses.

GET

/v2/inventory

curl --request GET \
  --url https://api.zentail.com/v2/inventory \
  --header 'Authorization: Bearer <token>'

Two uses. It scopes a sweep — report only these SKUs rather than your whole catalog. And it lets a caller send only genuine differences, which on a large catalog is the difference between a viable poll loop and a pointless one.

Authorizations

• zentail_oauth
  inventory:self

Parameters

Query Parameters

updatedSince

string format: date-time

Optional: only SKUs whose Zentail-side quantity changed since this time. Omit for a full listing.

cursor

string

Leave empty for the first page; pass next_cursor thereafter.

pageSize

integer format: int32

Server-capped. Omit for the default.

Responses

200

A successful response.

Media typeapplication/json

object

items

One entry per SKU-and-warehouse pair, so a SKU stocked in two of the caller’s warehouses appears twice. Empty when the filter matched nothing, which is not an error.

Array<object>

object

sku

Zentail’s SKU for the product, and the value to send back on an InventoryUpdate. Mapping it to the integration’s own product code is the caller’s job; a mismatch here is the usual cause of UNKNOWN_SKU.

string

warehouseUniqueId

The caller’s own identifier for the warehouse, not Zentail’s internal id.

string

quantity

What Zentail currently believes is on hand.

integer format: int32

lastUpdatedTs

When that belief was last updated, by anyone.

string format: date-time

nextCursor

Empty when the page is the last one.

string

Example^generated

{
  "items": [
    {
      "sku": "example",
      "warehouseUniqueId": "example",
      "quantity": 1,
      "lastUpdatedTs": "2026-04-15T12:00:00Z"
    }
  ],
  "nextCursor": "example"
}

default

An unexpected error response.

Media typeapplication/json

object

code

integer format: int32

message

string

details

Array<object>

object

@type

string

key

additional properties

Example^generated

{
  "code": 1,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}