Store API

The Store API is what a storefront talks to. It extends Medusa’s store routes with marketplace discovery (sellers and offers) and replaces the cart completion flow with the multi-vendor order-group split. Most routes are public, and customer authentication requirements are noted per group. See API conventions for pagination and field selection.

Products and discovery

Method	Path	Purpose
`GET`	`/store/products`	List published products (filtered to sellers visible to the shopper)
`GET`	`/store/products/:id`	Retrieve a product
`GET`	`/store/product-categories[/:id]`	Category tree with media and icons
`GET`	`/store/product-attributes[/:id]`	Filterable attributes for building facet UIs

Sellers

Method	Path	Purpose
`GET`	`/store/sellers`	List public seller storefronts (only `open` sellers outside a closure window)
`GET`	`/store/sellers/:id`	Retrieve a seller storefront

Offers

Method	Path	Purpose
`GET`	`/store/offers`	List offers, with per-offer calculated prices
`GET`	`/store/offers/:id`	Retrieve an offer

Carts and checkout

Mercur overrides the cart routes so a single cart can span multiple sellers:

Method	Path	Purpose
`POST`	`/store/carts/:id/line-items`	Add a line item (offer-aware, multi-seller)
`POST`	`/store/carts/:id/shipping-methods`	Add per-seller shipping methods
`GET`	`/store/shipping-options`	Shipping options available for the cart, grouped by seller
`POST`	`/store/carts/:id/promotions`	Apply promotions
`POST`	`/store/carts/:id/complete`	Complete the cart, splitting it into per-seller orders under an order group

Order groups

Customer authentication required.

Method	Path	Purpose
`GET`	`/store/order-groups`	The customer’s order groups
`GET`	`/store/order-groups/:id`	An order group with its per-seller child orders

Overview

Panel extensions

Admin API

Vendor API

Configuration

Store API

Products and discovery

Sellers

Offers

Carts and checkout

Order groups

Next steps

Order groups

​Products and discovery

​Sellers

​Offers

​Carts and checkout

​Order groups

​Next steps

Order groups

Products and discovery

Sellers

Offers

Carts and checkout

Order groups

Next steps