Procurement API Reference

Reference for Procurement API resources, request conventions, pagination, filtering and response behavior.

Base URL

api.mediloop.com/v1

Authentication

Bearer + tenant context

Pagination

Cursor / filtered

Limits

Resource-specific

Base URL & authentication

cURLJavaScriptPython

GET /v1/procurement/products HTTP/1.1
Host: api.mediloop.com
Authorization: Bearer $MEDILOOP_API_KEY
X-Tenant-Id: $TENANT_ID
Accept: application/json

Authenticated request

Resources

Resource	Primary endpoints	Purpose
Suppliers	GET /v1/suppliers	Supplier discovery and profiles
Products	GET /v1/procurement/products	Procurement catalog search
Purchase Orders	GET/POST /v1/purchase-orders	Order lifecycle
Deliveries	GET /v1/procurement/deliveries	Fulfilment tracking
Invoices	GET /v1/procurement/invoices	Invoice reconciliation
Payments	GET /v1/procurement/payments	Payment status
Returns	GET/POST /v1/procurement/returns	Return workflows
Price Agreements	GET/POST /v1/price-agreements	Negotiated terms
Stock Availability	GET /v1/stock/availability	Availability and reservations

Pagination

Parameter	Meaning
cursor	Opaque cursor from previous response
limit	Page size, subject to endpoint limits
next_cursor	Cursor for the next page; null when complete

Filtering & sorting

Filters are endpoint-specific and combinable where documented. Prefer explicit filters such as supplier, status, category, date range and availability instead of repeatedly scanning complete datasets.

Idempotency

Create and state-changing endpoints that support retries accept an Idempotency-Key. Reuse the same key only for the same logical operation and payload.

Rate limits

Endpoint family	Illustrative default
General procurement	100 requests / min
Stock availability	300 requests / min
Bulk / export operations	Lower resource-specific limits
Enterprise	Contract-specific capacity

Response codes

HTTP	Meaning
200	Successful read / update
201	Resource created
204	Successful delete / no content
400	Invalid request
401	Authentication failed
403	Insufficient scope / tenant permission
404	Resource not found
409	Conflict or lifecycle violation
429	Rate limit exceeded