Skip to content
Zentail Developer Docs

ListUpdateListings will return any listing that:

You call thisScope not enforced

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

  1. Has at least one Variant with a channel ID

  2. Has a Product Data change since the last timestamp (including Variants)

  3. Product Data is enabled for the Listing

Authorizations

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters”
since
string format: date-time
cursor
string

Responses

Section titled “ Responses ”

200

Section titled “200”

A successful response.

Media typeapplication/json
ListListingsResponse is the response object containing a list of Listings
object
listings
Array<object>
Listing is a representation of a product to be sold on a Channel LATER: comment this more
object
id
string
sku
A SKU to represent the entire listing (this is usually a value that is different than any of the SKUs of the Variants)
string
productData
object
enabled
boolean
categoryId
string
productTypeId
string
pivotAttributes
Array<string>
attributes
Array<object>
Attribute has data that describes a Listing or a Listing's Variants
object
id
string
textValue
string
numericValue
number format: double
numericWithUnitsValue
NumericWithUnits supports values like 1 lb
object
numeric
number format: double
units
string
multiTextValue
MultiText supports a value that has multiple sub-values (e.g. bullet points)
object
values
Array<string>
moneyValue
Money supports values like with amount and currency_code
object
amount
string
currencyCode
string
multiObjectValue
Object supports a set of keys and values
object
items
Array<object>
object
properties
object
key
additional properties
object
textValue
string
numericValue
number format: double
numericWithUnitsValue
NumericWithUnits supports values like 1 lb
object
numeric
number format: double
units
string
multiTextValue
MultiText supports a value that has multiple sub-values (e.g. bullet points)
object
values
Array<string>
moneyValue
Money supports values like with amount and currency_code
object
amount
string
currencyCode
string
multiObjectValue
object recursive
versionId
string
updatedAt
string format: date-time
submittedAt
string format: date-time
updatedAt
string format: date-time
swatchImageAttributeId

Channel aspect id(s) whose values drive per-variant images (e.g. eBay variesBy.aspectsImageVariesBy); empty means infer. Per ZEN-3240.

Array<string>
variants
Array<object>
Variant is a representation of a specific SKU in a listing LATER: comment this more
object
sku
string
channelId
string
settings

Any Integration-level Settings will be merged with Variant-level Settings to produce these Settings.

object
key
additional properties
string
inventory
Inventory contains information about the availability of this variant
object
enabled
boolean
totalQuantity
total_quantity should be the sum of merchant_fulfillable_inventory and storefront_fulfillable_quantity
string format: int64
merchantFulfillableQuantity
string format: int64
merchantFulfillableWarehouseQuantities
Array<object>
object
warehouseId
string
quantity
string format: int64
storefrontFulfillableQuantity
string format: int64
updatedAt
string format: date-time
identifiers
Attributes is a container for a list of attributes of a similar classification
object
enabled
boolean
attributes
Array<object>
Attribute has data that describes a Listing or a Listing's Variants
object
id
string
textValue
string
numericValue
number format: double
numericWithUnitsValue
NumericWithUnits supports values like 1 lb
object
numeric
number format: double
units
string
multiTextValue
MultiText supports a value that has multiple sub-values (e.g. bullet points)
object
values
Array<string>
moneyValue
Money supports values like with amount and currency_code
object
amount
string
currencyCode
string
multiObjectValue
Object supports a set of keys and values
object
items
Array<object>
object
properties
object
key
additional properties
object
textValue
string
numericValue
number format: double
numericWithUnitsValue
NumericWithUnits supports values like 1 lb
object
numeric
number format: double
units
string
multiTextValue
MultiText supports a value that has multiple sub-values (e.g. bullet points)
object
values
Array<string>
moneyValue
Money supports values like with amount and currency_code
object
amount
string
currencyCode
string
multiObjectValue
object recursive
versionId
string
updatedAt
string format: date-time
submittedAt
string format: date-time
updatedAt
string format: date-time
productData
Attributes is a container for a list of attributes of a similar classification
object
enabled
boolean
attributes
Array<object>
Attribute has data that describes a Listing or a Listing's Variants
object
id
string
textValue
string
numericValue
number format: double
numericWithUnitsValue
NumericWithUnits supports values like 1 lb
object
numeric
number format: double
units
string
multiTextValue
MultiText supports a value that has multiple sub-values (e.g. bullet points)
object
values
Array<string>
moneyValue
Money supports values like with amount and currency_code
object
amount
string
currencyCode
string
multiObjectValue
Object supports a set of keys and values
object
items
Array<object>
object
properties
object
key
additional properties
object
textValue
string
numericValue
number format: double
numericWithUnitsValue
NumericWithUnits supports values like 1 lb
object
numeric
number format: double
units
string
multiTextValue
MultiText supports a value that has multiple sub-values (e.g. bullet points)
object
values
Array<string>
moneyValue
Money supports values like with amount and currency_code
object
amount
string
currencyCode
string
multiObjectValue
object recursive
versionId
string
updatedAt
string format: date-time
submittedAt
string format: date-time
updatedAt
string format: date-time
pricing
Pricing is a container for a list of pricing attributes as well as structured information about scheduled sales
object
enabled
boolean
attributes
Array<object>
Attribute has data that describes a Listing or a Listing's Variants
object
id
string
textValue
string
numericValue
number format: double
numericWithUnitsValue
NumericWithUnits supports values like 1 lb
object
numeric
number format: double
units
string
multiTextValue
MultiText supports a value that has multiple sub-values (e.g. bullet points)
object
values
Array<string>
moneyValue
Money supports values like with amount and currency_code
object
amount
string
currencyCode
string
multiObjectValue
Object supports a set of keys and values
object
items
Array<object>
object
properties
object
key
additional properties
object
textValue
string
numericValue
number format: double
numericWithUnitsValue
NumericWithUnits supports values like 1 lb
object
numeric
number format: double
units
string
multiTextValue
MultiText supports a value that has multiple sub-values (e.g. bullet points)
object
values
Array<string>
moneyValue
Money supports values like with amount and currency_code
object
amount
string
currencyCode
string
multiObjectValue
object recursive
versionId
string
updatedAt
string format: date-time
submittedAt
string format: date-time
updatedAt
string format: date-time
sales
Array<object>
object
strikeThroughPrice
number format: double
salePrice
number format: double
startAt
string format: date-time
endAt
string format: date-time
logistics
Attributes is a container for a list of attributes of a similar classification
object
enabled
boolean
attributes
Array<object>
Attribute has data that describes a Listing or a Listing's Variants
object
id
string
textValue
string
numericValue
number format: double
numericWithUnitsValue
NumericWithUnits supports values like 1 lb
object
numeric
number format: double
units
string
multiTextValue
MultiText supports a value that has multiple sub-values (e.g. bullet points)
object
values
Array<string>
moneyValue
Money supports values like with amount and currency_code
object
amount
string
currencyCode
string
multiObjectValue
Object supports a set of keys and values
object
items
Array<object>
object
properties
object
key
additional properties
object
textValue
string
numericValue
number format: double
numericWithUnitsValue
NumericWithUnits supports values like 1 lb
object
numeric
number format: double
units
string
multiTextValue
MultiText supports a value that has multiple sub-values (e.g. bullet points)
object
values
Array<string>
moneyValue
Money supports values like with amount and currency_code
object
amount
string
currencyCode
string
multiObjectValue
object recursive
versionId
string
updatedAt
string format: date-time
submittedAt
string format: date-time
updatedAt
string format: date-time
createdAt
string format: date-time
updatedAt
string format: date-time
nextPageCursor

The cursor token for the next page of results. If empty, there are no more results.

string
Examplegenerated
{
  "listings": [
    {
      "id": "example",
      "sku": "example",
      "productData": {
        "enabled": true,
        "categoryId": "example",
        "productTypeId": "example",
        "pivotAttributes": [
          "example"
        ],
        "attributes": [
          {
            "id": "example",
            "textValue": "example",
            "numericValue": 1,
            "numericWithUnitsValue": {
              "numeric": 1,
              "units": "example"
            },
            "multiTextValue": {
              "values": [
                "example"
              ]
            },
            "moneyValue": {
              "amount": "example",
              "currencyCode": "example"
            },
            "multiObjectValue": {
              "items": [
                {
                  "properties": {
                    "additionalProperty": {
                      "textValue": "example",
                      "numericValue": 1,
                      "numericWithUnitsValue": {
                        "numeric": 1,
                        "units": "example"
                      },
                      "multiTextValue": {
                        "values": [
                          "example"
                        ]
                      },
                      "moneyValue": {
                        "amount": "example",
                        "currencyCode": "example"
                      },
                      "multiObjectValue": {}
                    }
                  }
                }
              ]
            },
            "versionId": "example",
            "updatedAt": "2026-04-15T12:00:00Z",
            "submittedAt": "2026-04-15T12:00:00Z"
          }
        ],
        "updatedAt": "2026-04-15T12:00:00Z",
        "swatchImageAttributeId": [
          "example"
        ]
      },
      "variants": [
        {
          "sku": "example",
          "channelId": "example",
          "settings": {
            "additionalProperty": "example"
          },
          "inventory": {
            "enabled": true,
            "totalQuantity": "example",
            "merchantFulfillableQuantity": "example",
            "merchantFulfillableWarehouseQuantities": [
              {
                "warehouseId": "example",
                "quantity": "example"
              }
            ],
            "storefrontFulfillableQuantity": "example",
            "updatedAt": "2026-04-15T12:00:00Z"
          },
          "identifiers": {
            "enabled": true,
            "attributes": [
              {
                "id": "example",
                "textValue": "example",
                "numericValue": 1,
                "numericWithUnitsValue": {
                  "numeric": 1,
                  "units": "example"
                },
                "multiTextValue": {
                  "values": [
                    "example"
                  ]
                },
                "moneyValue": {
                  "amount": "example",
                  "currencyCode": "example"
                },
                "multiObjectValue": {
                  "items": [
                    {
                      "properties": {
                        "additionalProperty": {
                          "textValue": "example",
                          "numericValue": 1,
                          "numericWithUnitsValue": {
                            "numeric": 1,
                            "units": "example"
                          },
                          "multiTextValue": {
                            "values": [
                              "example"
                            ]
                          },
                          "moneyValue": {
                            "amount": "example",
                            "currencyCode": "example"
                          },
                          "multiObjectValue": {}
                        }
                      }
                    }
                  ]
                },
                "versionId": "example",
                "updatedAt": "2026-04-15T12:00:00Z",
                "submittedAt": "2026-04-15T12:00:00Z"
              }
            ],
            "updatedAt": "2026-04-15T12:00:00Z"
          },
          "productData": {
            "enabled": true,
            "attributes": [
              {
                "id": "example",
                "textValue": "example",
                "numericValue": 1,
                "numericWithUnitsValue": {
                  "numeric": 1,
                  "units": "example"
                },
                "multiTextValue": {
                  "values": [
                    "example"
                  ]
                },
                "moneyValue": {
                  "amount": "example",
                  "currencyCode": "example"
                },
                "multiObjectValue": {
                  "items": [
                    {
                      "properties": {
                        "additionalProperty": {
                          "textValue": "example",
                          "numericValue": 1,
                          "numericWithUnitsValue": {
                            "numeric": 1,
                            "units": "example"
                          },
                          "multiTextValue": {
                            "values": [
                              "example"
                            ]
                          },
                          "moneyValue": {
                            "amount": "example",
                            "currencyCode": "example"
                          },
                          "multiObjectValue": {}
                        }
                      }
                    }
                  ]
                },
                "versionId": "example",
                "updatedAt": "2026-04-15T12:00:00Z",
                "submittedAt": "2026-04-15T12:00:00Z"
              }
            ],
            "updatedAt": "2026-04-15T12:00:00Z"
          },
          "pricing": {
            "enabled": true,
            "attributes": [
              {
                "id": "example",
                "textValue": "example",
                "numericValue": 1,
                "numericWithUnitsValue": {
                  "numeric": 1,
                  "units": "example"
                },
                "multiTextValue": {
                  "values": [
                    "example"
                  ]
                },
                "moneyValue": {
                  "amount": "example",
                  "currencyCode": "example"
                },
                "multiObjectValue": {
                  "items": [
                    {
                      "properties": {
                        "additionalProperty": {
                          "textValue": "example",
                          "numericValue": 1,
                          "numericWithUnitsValue": {
                            "numeric": 1,
                            "units": "example"
                          },
                          "multiTextValue": {
                            "values": [
                              "example"
                            ]
                          },
                          "moneyValue": {
                            "amount": "example",
                            "currencyCode": "example"
                          },
                          "multiObjectValue": {}
                        }
                      }
                    }
                  ]
                },
                "versionId": "example",
                "updatedAt": "2026-04-15T12:00:00Z",
                "submittedAt": "2026-04-15T12:00:00Z"
              }
            ],
            "updatedAt": "2026-04-15T12:00:00Z",
            "sales": [
              {
                "strikeThroughPrice": 1,
                "salePrice": 1,
                "startAt": "2026-04-15T12:00:00Z",
                "endAt": "2026-04-15T12:00:00Z"
              }
            ]
          },
          "logistics": {
            "enabled": true,
            "attributes": [
              {
                "id": "example",
                "textValue": "example",
                "numericValue": 1,
                "numericWithUnitsValue": {
                  "numeric": 1,
                  "units": "example"
                },
                "multiTextValue": {
                  "values": [
                    "example"
                  ]
                },
                "moneyValue": {
                  "amount": "example",
                  "currencyCode": "example"
                },
                "multiObjectValue": {
                  "items": [
                    {
                      "properties": {
                        "additionalProperty": {
                          "textValue": "example",
                          "numericValue": 1,
                          "numericWithUnitsValue": {
                            "numeric": 1,
                            "units": "example"
                          },
                          "multiTextValue": {
                            "values": [
                              "example"
                            ]
                          },
                          "moneyValue": {
                            "amount": "example",
                            "currencyCode": "example"
                          },
                          "multiObjectValue": {}
                        }
                      }
                    }
                  ]
                },
                "versionId": "example",
                "updatedAt": "2026-04-15T12:00:00Z",
                "submittedAt": "2026-04-15T12:00:00Z"
              }
            ],
            "updatedAt": "2026-04-15T12:00:00Z"
          }
        }
      ],
      "createdAt": "2026-04-15T12:00:00Z",
      "updatedAt": "2026-04-15T12:00:00Z"
    }
  ],
  "nextPageCursor": "example"
}

default

Section titled “default”

An unexpected error response.

Media typeapplication/json
object
code
integer format: int32
message
string
details
Array<object>
object
@type
string
key
additional properties
Examplegenerated
{
  "code": 1,
  "message": "example",
  "details": [
    {
      "@type": "example"
    }
  ]
}

Sourceapi-proto@afdb30cc via [email protected]

Built0c509dd3

This page describes the source document as deployed: the version listing pinned in its release r2026.09.24.02. A change merged upstream shows up here once it has deployed and the pins are next refreshed.

API changelog