Marketplace API
Build commerce experiences on Mediloop: discover products, manage listings, place orders, process payments and receive marketplace events.
Authentication
OAuth 2.0
Permissions
marketplace:*
Rate limit
120 requests / min
Response
200 OK
Overview
The Marketplace API is the commerce layer for public-safe products. Prescription-required and otherwise restricted medicines are not exposed for public marketplace sale.
Key capabilities
Catalog
Discover products, categories, pricing and availability.
Listings
Create and publish seller-specific Marketplace offers.
Orders
Create and track orders through the commerce lifecycle.
Payments
Track payment, refund, settlement and payout state.
Available endpoints
| Area | Core endpoints | Purpose |
|---|---|---|
Catalog | /products · /categories | Product discovery |
Listings | /listings | Seller offers and publishing |
Compliance | /publish-guard | Public marketplace eligibility |
Orders | /orders | Checkout and order lifecycle |
Payments | /payments · /refunds · /settlements | Financial lifecycle |
Webhooks | Marketplace event types | Real-time state changes |
Workflow
1
Discover
2
Create listing
3
Publish
4
Order
5
Settle
Authentication
Authenticated request
GET /v1/products HTTP/1.1
Host: api.mediloop.com
Authorization: Bearer $ACCESS_TOKEN
X-Tenant-Id: $TENANT_IDCommon use cases
| Use case | APIs |
|---|---|
Marketplace storefront | Catalog + Listings |
Seller portal | Listings + Compliance |
Checkout | Orders + Payments |
Finance operations | Refunds + Settlement + Reconciliation |
Event-driven integration | Webhooks |