Skip to main content
GET
/
vendor
/
offers
/
{id}
curl 'http://localhost:9000/vendor/offers/offer_01HXYZ' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>'
{
  "offer": {
    "id": "offer_01HXYZ",
    "seller_id": "sel_01HXYZ",
    "variant_id": "variant_01HXYZ",
    "product_id": "prod_01HXYZ",
    "sku": "ACME-SHIRT-M",
    "prices": [
      { "id": "price_01HXYZ", "amount": 2500, "currency_code": "usd" }
    ],
    "inventory_items": [
      { "inventory_item_id": "iitem_01HXYZ", "required_quantity": 1 }
    ]
  }
}
Returns a single offer owned by the seller; requesting another seller’s offer fails.

Path parameters

id
string
required
The offer’s ID.

Query parameters

fields
string
Comma-separated fields to include in the response. Prefix with +/- to add to or remove from the defaults.

Response

offer
object
curl 'http://localhost:9000/vendor/offers/offer_01HXYZ' \
  -H 'Authorization: Bearer <token>' \
  -H 'x-seller-id: <seller_id>'
{
  "offer": {
    "id": "offer_01HXYZ",
    "seller_id": "sel_01HXYZ",
    "variant_id": "variant_01HXYZ",
    "product_id": "prod_01HXYZ",
    "sku": "ACME-SHIRT-M",
    "prices": [
      { "id": "price_01HXYZ", "amount": 2500, "currency_code": "usd" }
    ],
    "inventory_items": [
      { "inventory_item_id": "iitem_01HXYZ", "required_quantity": 1 }
    ]
  }
}