x-seller-id mechanism described in API conventions — a seller can never read or mutate another seller’s data.
Account and team
| Method | Path | Purpose |
|---|---|---|
GET POST | /vendor/sellers | Registration lookup / create a seller account (public) |
POST | /vendor/sellers/select | Select the active seller for the session |
GET POST | /vendor/sellers/me | Retrieve / update the current seller |
POST | /vendor/sellers/:id/address | Upsert the seller address |
POST | /vendor/sellers/:id/payment-details | Upsert payment details |
POST DELETE | /vendor/sellers/:id/professional-details | Upsert / remove professional details |
GET POST | /vendor/sellers/:id/members | List / manage members |
POST DELETE | /vendor/sellers/:id/members/:member_id | Update role / remove a member |
GET | /vendor/sellers/:id/members/me | The current member within this seller |
GET | /vendor/sellers/:id/members/invites | List pending invites |
GET POST | /vendor/members/me | Retrieve / update the current member profile |
POST | /vendor/members/invites/accept | Accept an invite (public) |
Products and offers
Products are shared master records: updates stage a change request rather than writing directly, and the list shows products the seller created plus published, unrestricted products.| Method | Path | Purpose |
|---|---|---|
GET POST | /vendor/products | List / create a product (created as proposed) |
GET POST DELETE | /vendor/products/:id | Retrieve / request an update / request deletion |
GET | /vendor/products/:id/preview | Preview with pending changes applied |
POST | /vendor/products/:id/cancel | Withdraw the pending change request |
POST | /vendor/products/:id/attributes/batch | Batch add / update / remove attributes |
GET POST | /vendor/products/:id/variants | List / create variants |
GET POST DELETE | /vendor/products/:id/variants/:variant_id | Retrieve / update / delete a variant |
GET | /vendor/product-variants | List variants across products |
GET POST | /vendor/offers | List / create offers |
GET POST DELETE | /vendor/offers/:id | Retrieve / update / delete an offer |
POST | /vendor/offers/batch | Batch create offers |
POST | /vendor/offers/:id/inventory-items/batch | Link inventory items to an offer |
Catalog taxonomy (read-only)
GET /vendor/product-categories[/:id], /vendor/product-tags[/:id], /vendor/product-types[/:id], /vendor/product-attributes[/:id], /vendor/collections[/:id] — plus POST /vendor/product-categories/:id/products and POST /vendor/collections/:id/products to place own products.
Orders and fulfillment
| Method | Path | Purpose |
|---|---|---|
GET | /vendor/orders | List the seller’s orders |
GET | /vendor/orders/:id | Retrieve an order |
GET | /vendor/orders/:id/preview | Preview with pending edits |
GET | /vendor/orders/:id/changes | List order changes |
GET | /vendor/orders/:id/commission-lines | Commission charged on the order |
POST | /vendor/orders/:id/complete | Complete the order |
POST | /vendor/orders/:id/cancel | Cancel the order |
POST | /vendor/orders/:id/fulfillments | Create a fulfillment |
POST | /vendor/orders/:id/fulfillments/:fulfillment_id/cancel | Cancel a fulfillment |
POST | /vendor/orders/:id/fulfillments/:fulfillment_id/mark-as-delivered | Mark delivered |
POST | /vendor/orders/:id/fulfillments/:fulfillment_id/shipments | Create a shipment |
Order edits, returns, claims, exchanges
Full RMA suites exist per domain, following the same action pattern Medusa uses (begin → stage item/shipping actions → request → confirm):POST /vendor/order-edits+/:id/request|confirm|items|shipping-methodsub-routesGET/POST /vendor/returns+/:id/request-items|dismiss-items|receive-items|receive|shipping-methodsub-routesGET/POST /vendor/claims+/:id/claim-items|inbound|outboundsub-routesGET/POST /vendor/exchanges+/:id/inbound|outboundsub-routesGET /vendor/return-reasons[/:id],GET /vendor/refund-reasons[/:id]
Payments
| Method | Path | Purpose |
|---|---|---|
GET | /vendor/payments[/:id] | List / retrieve payments |
POST | /vendor/payments/:id/capture | Capture a payment |
POST | /vendor/payments/:id/refund | Refund a payment |
GET | /vendor/payments/payment-providers | List payment providers |
Payouts
| Method | Path | Purpose |
|---|---|---|
GET | /vendor/payouts[/:id] | Payout history |
GET POST | /vendor/payout-accounts | Retrieve / create the payout account |
POST | /vendor/payout-accounts/:id/onboarding | Start or refresh provider onboarding |
Inventory and stock locations
| Method | Path | Purpose |
|---|---|---|
GET POST | /vendor/inventory-items | List / create inventory items |
GET POST DELETE | /vendor/inventory-items/:id | Retrieve / update / delete an item |
GET POST | /vendor/inventory-items/:id/location-levels | List / create location levels |
POST DELETE | /vendor/inventory-items/:id/location-levels/:location_id | Update / delete a level |
POST | /vendor/inventory-items/location-levels/batch | Batch update levels |
GET POST | /vendor/reservations[/:id] | Manage reservations |
GET POST | /vendor/stock-locations | List / create stock locations |
GET POST DELETE | /vendor/stock-locations/:id | Retrieve / update / delete a location |
POST | /vendor/stock-locations/:id/fulfillment-sets | Create a fulfillment set |
POST | /vendor/stock-locations/:id/fulfillment-providers | Link fulfillment providers |
POST | /vendor/stock-locations/:id/sales-channels | Link sales channels |
Shipping
| Method | Path | Purpose |
|---|---|---|
GET POST | /vendor/shipping-options | List / create shipping options |
GET POST DELETE | /vendor/shipping-options/:id | Retrieve / update / delete an option |
POST | /vendor/shipping-options/:id/rules/batch | Batch manage option rules |
GET | /vendor/shipping-option-types[/:id] | List option types |
GET POST | /vendor/shipping-profiles | List / create profiles |
GET POST DELETE | /vendor/shipping-profiles/:id | Retrieve / update / delete a profile |
DELETE | /vendor/fulfillment-sets/:id | Delete a fulfillment set |
POST | /vendor/fulfillment-sets/:id/service-zones | Create a service zone |
GET POST DELETE | /vendor/fulfillment-sets/:id/service-zones/:zone_id | Manage a service zone |
GET | /vendor/fulfillment-providers | List fulfillment providers |
Pricing, promotions, customers
| Method | Path | Purpose |
|---|---|---|
GET POST | /vendor/price-lists[/:id] | Manage price lists (+ /:id/prices, /:id/prices/batch, /:id/products) |
GET | /vendor/price-preferences[/:id] | Read price preferences |
GET POST | /vendor/promotions[/:id] | Manage promotions (+ rule batch sub-routes and rule option lookups) |
GET POST | /vendor/campaigns[/:id] | Manage campaigns (+ /:id/promotions) |
GET | /vendor/customers[/:id] | The seller’s customers |
POST | /vendor/customers/:id/customer-groups | Manage a customer’s groups |
GET POST | /vendor/customer-groups[/:id] | Manage customer groups (+ /:id/customers) |
Configuration and misc
| Method | Path | Purpose |
|---|---|---|
GET POST | /vendor/sales-channels[/:id] | Manage sales channels (+ /:id/products) |
GET | /vendor/regions[/:id] | Read regions |
GET | /vendor/currencies[/:code] | Read currencies |
GET | /vendor/stores | List stores (public) |
GET | /vendor/feature-flags | Feature flags (public) |
POST | /vendor/uploads | Upload files |