API Reference

Complete reference for all Supplier API endpoints. All endpoints are relative to https://api.mediloop.com/v1

GET /v1/products

POST /v1/products

PUT /v1/products/{id}

DELETE /v1/products/{id}

Base URL & authentication

Endpoints

Across 10 resources

100%

HTTPS

Secure by default

Role-based access

Permissions

Fine grained scopes

Rate limited

Per API key

Configurable limits

Resources

CatalogProducts, prices, attributes, categories14

InventoryStock levels, availability, locations10

OrdersOrders, order items, status updates9

PricingPrice lists, rules, promotions8

MarketplacePublishing, offers, visibility7

WebhooksEvents, subscriptions, deliveries6

FilesFile uploads, documents, media5

SuppliersCompany profile, users, API keys7

AnalyticsReports, metrics, insights5

NotificationsMessages, alerts, preferences7

GET/v1/products/{id}

Retrieve a product

Path parameters

idstringThe unique product identifier

Query parameters

includestringComma separated list of related resources

pageintegerPage number (default: 1)

limitintegerItems per page (default: 20, max: 100)

RequestResponsecURLJavaScriptPython

GET /v1/products/123...?include=prices,stock&page=1&limit=20 HTTP/1.1
Host: api.mediloop.com
Authorization: Bearer $MEDILOOP_API_KEY
Accept: application/json
X-Tenant-Id: 2f8c9d41-...

Pagination

?page=1&limit=20 keeps large collections predictable.

Filtering & sorting

GET /v1/products?category=analgesics&availability=available&sort=-updated_at

Field selection

GET /v1/products/prod_123?include=prices,stock&fields=id,name,supplier_sku

Rate limits

Respect returned rate-limit headers and apply backoff before retrying throttled requests.

Response codes

2xx Success

Request completed successfully.

4xx Client error

Fix request, authorization or state.

429 Rate limited

Wait for reset and retry later.

5xx Service error

Transient service failure.