> ## 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.

# Create Offer

> Create a listing for a product variant.

Creates the seller's offer for a variant — the seller's SKU, shipping profile, prices, and backing inventory.

<Note>
  A product can be listed by many sellers; the offer is what carries the seller's own price and stock for a variant.
</Note>

## Query parameters

<ParamField query="fields" type="string">
  Comma-separated fields to include in the returned offer. Prefix with `+`/`-` to add to or remove from the defaults.
</ParamField>

## Body parameters

<ParamField body="sku" type="string" required>
  The seller's SKU for this listing.
</ParamField>

<ParamField body="variant_id" type="string" required>
  ID of the product variant being listed.
</ParamField>

<ParamField body="shipping_profile_id" type="string" required>
  ID of the seller's shipping profile used to fulfill the offer.
</ParamField>

<ParamField body="inventory_items" type="object[]" required>
  Inventory items backing the offer; at least one is required.

  <Expandable title="properties">
    <ParamField body="title" type="string">Title for the created inventory item.</ParamField>
    <ParamField body="sku" type="string">SKU for the created inventory item.</ParamField>
    <ParamField body="required_quantity" type="number" default="1">Units of the item consumed per sale; positive integer.</ParamField>

    <ParamField body="stock_levels" type="object[]">
      <Expandable title="properties">
        <ParamField body="location_id" type="string" required>Stock location ID.</ParamField>
        <ParamField body="stocked_quantity" type="number" required>Stocked quantity at the location; non-negative integer.</ParamField>
      </Expandable>
    </ParamField>
  </Expandable>
</ParamField>

<ParamField body="prices" type="object[]" required>
  Offer prices; at least one is required.

  <Expandable title="properties">
    <ParamField body="amount" type="number" required>Price amount.</ParamField>
    <ParamField body="currency_code" type="string" required>Currency code, e.g. `usd`.</ParamField>
    <ParamField body="min_quantity" type="number">Minimum quantity for the price to apply; positive integer.</ParamField>
    <ParamField body="max_quantity" type="number">Maximum quantity for the price to apply; positive integer.</ParamField>
    <ParamField body="rules" type="object">Price rules as attribute-to-value pairs, e.g. `{"region_id": "reg_01..."}`.</ParamField>
  </Expandable>
</ParamField>

<ParamField body="ean" type="string">
  EAN barcode.
</ParamField>

<ParamField body="upc" type="string">
  UPC barcode.
</ParamField>

<ParamField body="metadata" type="object">
  Custom key-value pairs.
</ParamField>

## Response

<ResponseField name="offer" type="object">
  <Expandable title="properties">
    <ResponseField name="id" type="string">The offer's ID.</ResponseField>
    <ResponseField name="seller_id" type="string">ID of the owning seller.</ResponseField>
    <ResponseField name="variant_id" type="string">ID of the listed product variant.</ResponseField>
    <ResponseField name="product_id" type="string">ID of the parent product.</ResponseField>
    <ResponseField name="shipping_profile_id" type="string">ID of the shipping profile.</ResponseField>
    <ResponseField name="sku" type="string">The seller's SKU for this listing.</ResponseField>
    <ResponseField name="prices" type="object[]">Offer prices with `id`, `amount`, `currency_code`, `min_quantity`, `max_quantity`, and `price_rules`.</ResponseField>
    <ResponseField name="inventory_items" type="object[]">Linked inventory items with `id`, `inventory_item_id`, `required_quantity`, and `sku`.</ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST 'http://localhost:9000/vendor/offers' \
    -H 'Authorization: Bearer <token>' \
    -H 'x-seller-id: <seller_id>' \
    -H 'Content-Type: application/json' \
    -d '{
      "sku": "ACME-SHIRT-M",
      "variant_id": "variant_01HXYZ",
      "shipping_profile_id": "sp_01HXYZ",
      "prices": [{ "amount": 2500, "currency_code": "usd" }],
      "inventory_items": [
        {
          "required_quantity": 1,
          "stock_levels": [{ "location_id": "sloc_01HXYZ", "stocked_quantity": 100 }]
        }
      ]
    }'
  ```

  ```ts JS Client theme={null}
  const { offer } = await client.vendor.offers.mutate({
    sku: "ACME-SHIRT-M",
    variant_id: "variant_01HXYZ",
    shipping_profile_id: "sp_01HXYZ",
    prices: [{ amount: 2500, currency_code: "usd" }],
    inventory_items: [
      {
        required_quantity: 1,
        stock_levels: [{ location_id: "sloc_01HXYZ", stocked_quantity: 100 }],
      },
    ],
  })
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "offer": {
      "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 }
      ]
    }
  }
  ```
</ResponseExample>