Procurement API
Invoices
Retrieve procurement invoices and reconcile them against purchase orders and fulfilment records.
Lifecycle
Issued → reconciled
Reconciliation
PO + delivery matching
Totals
Tax-aware amounts
Documents
Invoice attachments
Invoice lifecycle
issuedmatchingreconciledsettledInvoice records
| Field | Description | Example |
|---|---|---|
| invoice_number | Supplier invoice identifier | INV-2026-00191 |
| purchase_order_id | Linked Mediloop PO | po_42 |
| supplier_id | Issuer | sup_42 |
| currency | Invoice currency | EUR |
| subtotal / tax / total | Financial totals | 178 / 30.26 / 208.26 |
| status | Invoice state | issued |
Order reconciliation
Purchase order
Expected products, quantities and commercial terms.
Fulfilment
Actually delivered quantities and exceptions.
Invoice
Amounts billed and reconciliation outcome.
Tax & totals
| Amount | Description |
|---|---|
| subtotal | Line totals before taxes |
| discount_total | Agreement / commercial discounts |
| tax_total | Applicable taxes |
| shipping_total | Shipping / handling when applicable |
| total | Final invoice amount |
Documents
Invoice documents can be referenced from the procurement invoice record while access control, audit and retention are handled by the Mediloop Files/Documents capability.
Example request
cURLJavaScriptPython
curl "https://api.mediloop.com/v1/procurement/invoices/inv_91" \
-H "Authorization: Bearer $MEDILOOP_API_KEY" \
-H "X-Tenant-Id: $TENANT_ID"Get invoice
Response200 OK
{
"id":"inv_91", "invoice_number":"INV-2026-00191", "purchase_order_id":"po_42",
"status":"reconciled", "total":{"amount":208.26,"currency":"EUR"}
}