> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mercurjs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve Offer

> Retrieve a seller offer by ID with its per-offer calculated price.

Returns a single offer; offers from hidden sellers or on unpublished products return a `404`.

> [!NOTE]
>
> Customer authentication is optional. `calculated_price` is computed per offer only when requested in `fields` and a pricing context (`region_id`, `country_code`, or `cart_id`) resolves; requesting `inventory_quantity` or `in_stock` requires a single sales channel on the publishable key or via `sales_channel_id`.

## Path parameters

**id** `string` *required*

The offer's ID.

## Query parameters

**fields** `string`

Comma-separated fields and relations to include; add `calculated_price`, `inventory_quantity`, or `in_stock` to receive the computed fields.

**region\_id** `string`

Region used to build the pricing context for `calculated_price`.

**country\_code** `string`

Country used for the tax portion of the pricing context.

**province** `string`

Province used for the tax portion of the pricing context.

**cart\_id** `string`

Cart whose region and customer resolve the pricing context.

## Response

**offer** `object`

**properties**

**id** `string`

The offer's ID.

**seller\_id** `string`

ID of the selling seller.

**variant\_id** `string`

ID of the offered product variant.

**product\_id** `string`

ID of the offered product.

**shipping\_profile\_id** `string | null`

ID of the offer's shipping profile.

**sku** `string | null`

The offer's SKU.

**ean** `string | null`

The offer's EAN.

**upc** `string | null`

The offer's UPC.

**seller** `object`

The seller's `id`, `name`, and `handle`.

**product\_variant** `object`

The variant's `id`, `title`, `sku`, and `price_set`.

**shipping\_profile** `object | null`

The shipping profile's `id` and `name`.

**prices** `object[]`

Raw offer prices with `amount`, `currency_code`, `min_quantity`, and `max_quantity`.

**inventory\_item\_link** `object[]`

Inventory items backing the offer, with location stock levels.

**calculated\_price** `object | null`

Per-offer calculated price with tax-adjusted amounts when a tax context resolves; only present when requested.

**inventory\_quantity** `number`

Available quantity in the sales channel's stock locations; only present when requested.

**in\_stock** `boolean`

Whether the offer has available inventory; only present when requested.

**metadata** `object | null`

Custom key-value data.

**created\_at** `string`

Creation timestamp.

**updated\_at** `string`

Last update timestamp.

```bash cURL theme={null}
curl 'http://localhost:9000/store/offers/offer_01JB2K6G5H?region_id=reg_01JB2K4S1T&fields=%2Bcalculated_price' \
  -H 'x-publishable-api-key: pk_01JB2K3XYZ'
```

```ts JS Client theme={null}
const { offer } = await client.store.offers.$id.query({
  $id: "offer_01JB2K6G5H",
  region_id: "reg_01JB2K4S1T",
  fields: "+calculated_price",
})
```

```json 200 theme={null}
{
  "offer": {
    "id": "offer_01JB2K6G5H",
    "seller_id": "sel_01JB2K8A1B",
    "variant_id": "variant_01JB2K6E4F",
    "product_id": "prod_01JB2K5M8N",
    "shipping_profile_id": "sp_01JB2K9C2D",
    "sku": "NT-LINEN-M",
    "ean": null,
    "upc": null,
    "seller": { "id": "sel_01JB2K8A1B", "name": "Nordic Textiles", "handle": "nordic-textiles" },
    "product_variant": { "id": "variant_01JB2K6E4F", "title": "M", "sku": null, "price_set": { "id": "pset_01JB2K9E3F" } },
    "shipping_profile": { "id": "sp_01JB2K9C2D", "name": "Default" },
    "prices": [
      { "id": "price_01JB2K9G4H", "amount": 4500, "currency_code": "eur", "min_quantity": null, "max_quantity": null }
    ],
    "inventory_item_link": [],
    "calculated_price": {
      "calculated_amount": 4500,
      "original_amount": 4500,
      "currency_code": "eur"
    },
    "metadata": null,
    "created_at": "2026-05-01T10:00:00.000Z",
    "updated_at": "2026-05-01T10:00:00.000Z"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.