Procurement API
Products & Catalog
Search procurement-ready products across approved supplier catalogs while preserving supplier, pricing and availability context.
Search
Cross-supplier catalog
Offers
Supplier-specific terms
Availability
Live fulfilment signals
Pagination
Cursor based
Catalog search
GET
/v1/procurement/products| Parameter | Type | Description | Example |
|---|---|---|---|
| q | string | Full-text product search | nitrile gloves |
| supplier_id | uuid | Limit to one supplier | sup_42 |
| category | string | Normalized category | consumables |
| availability | enum | Filter availability state | available |
| cursor | string | Pagination cursor | eyJpZCI6... |
Product records
| Field | Meaning | Procurement use |
|---|---|---|
| product_id | Normalized Mediloop product ID | Stable product reference |
| supplier_product_id | Supplier catalog item ID | Supplier-specific order line |
| sku / GTIN | Commercial identifiers | Matching and reconciliation |
| pack_size / uom | Order unit | Quantity validation |
| regulatory | Product compliance metadata | Eligibility checks |
Supplier offers
Supplier A
€8.90 / box · MOQ 10 · 2 days
Supplier B
€8.40 / box · MOQ 50 · 1 day
Supplier C
Agreement price €7.95 · 3 days
Availability
Availability is supplier-specific. Use the linked Stock Availability resource when the purchasing decision depends on location, lead time, reservation state or freshness.
Filtering & pagination
| Pattern | Recommendation |
|---|---|
| Cursor pagination | Use cursors for large catalog traversal |
| Sparse filters | Prefer supplier/category/availability filters to broad repeated search |
| Caching | Cache stable product metadata; refresh commercial/availability fields independently |
| Identifiers | Persist Mediloop IDs plus supplier SKU/GTIN for reconciliation |
Example request
cURLJavaScriptPython
curl "https://api.mediloop.com/v1/procurement/products?q=nitrile&availability=available" \
-H "Authorization: Bearer $MEDILOOP_API_KEY" \
-H "X-Tenant-Id: $TENANT_ID"Search products
Response200 OK
{
"data": [{
"id": "prod_123",
"name": "Nitrile Gloves M",
"offers": [{ "supplier_id": "sup_42", "price": 8.90, "currency": "EUR", "availability": "available" }]
}]
}