v1

latestOpenAPI 3.0.22026-07-223907721.1 MB

Offer

Stock Updates

Stock Updates (by Seller)

This endpoint retrieves stock updates for offers from a specific seller within a channel. It allows you to sync inventory changes for a particular seller's offers over time.

Returns a filtered list of stock changes that occurred after a specified timestamp for a specific seller.

get/v1/channel/offer/stock-updates

Query parameters

updatedAfterstring date-time required

Timestamp to filter stock updates. Only updates after this time will be returned.

Format: ISO 8601 timestamp

sellerIdstring required

A unique Id identify a Seller on a specific SalesChannel. The SellerId is generated from the Channel itself during the Seller SignUp Process.

Example:4711

ID of the seller whose stock updates should be returned.

Response

Successful response with stock updates for the specified seller

lastUpdatedAtstring date-time required

ISO 8601 timestamp indicating the lastest date of stock updates in the current list. Use this value as the updatedAfter parameter in subsequent requests to fetch only new stock updates.

Example response

{
  "stockUpdateList": [
    {
      "sellerId": "4711",
      "offerId": 5437233,
      "channelOfferId": "XCD233554",
      "quantity": 1,
      "updatedAt": "2025-12-29T14:13:06+00:00"
    }
  ],
  "lastUpdatedAt": "2025-12-29T14:13:06+00:00"
}