Skip to main content
GET
/
vendor
/
offers
curl 'http://localhost:9000/vendor/offers?variant_id=variant_01HXYZ' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>'

{
  "offers": [
    {
      "id": "offer_01HXYZ",
      "seller_id": "sel_01HXYZ",
      "variant_id": "variant_01HXYZ",
      "product_id": "prod_01HXYZ",
      "shipping_profile_id": "sp_01HXYZ",
      "sku": "ACME-SHIRT-M",
      "prices": [
        { "id": "price_01HXYZ", "amount": 2500, "currency_code": "usd" }
      ],
      "inventory_items": [
        { "inventory_item_id": "iitem_01HXYZ", "required_quantity": 1 }
      ]
    }
  ],
  "count": 1,
  "offset": 0,
  "limit": 50
}
Returns the seller’s offers with variant, shipping profile, prices, and linked inventory items.

​
Query parameters

​
limit
number
default:"50"
The maximum number of offers to return.
​
offset
number
default:"0"
The number of offers to skip before returning results.
​
order
string
The field to sort by, e.g. created_at or -created_at for descending.
​
fields
string
Comma-separated fields to include in the response. Prefix with +/- to add to or remove from the defaults.
​
q
string
Search term matched against offer fields.
​
id
string | string[]
Filter by offer ID(s).
​
variant_id
string | string[]
Filter by product variant ID(s).
​
shipping_profile_id
string | string[]
Filter by shipping profile ID(s).
​
sku
string | string[]
Filter by seller SKU(s).
​
ean
string | string[]
Filter by EAN(s).
​
upc
string | string[]
Filter by UPC(s).
​
created_at
object
Filter by creation date using operators like $gt, $lt, $gte, $lte.
​
updated_at
object
Filter by update date using operators like $gt, $lt, $gte, $lte.

​
Response

​
offers
object[]
​
count
number
Total number of matching offers.
​
offset
number
Number of skipped offers.
​
limit
number
Maximum number of returned offers.
curl 'http://localhost:9000/vendor/offers?variant_id=variant_01HXYZ' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>'

{
  "offers": [
    {
      "id": "offer_01HXYZ",
      "seller_id": "sel_01HXYZ",
      "variant_id": "variant_01HXYZ",
      "product_id": "prod_01HXYZ",
      "shipping_profile_id": "sp_01HXYZ",
      "sku": "ACME-SHIRT-M",
      "prices": [
        { "id": "price_01HXYZ", "amount": 2500, "currency_code": "usd" }
      ],
      "inventory_items": [
        { "inventory_item_id": "iitem_01HXYZ", "required_quantity": 1 }
      ]
    }
  ],
  "count": 1,
  "offset": 0,
  "limit": 50
}