Skip to main content

Get Supplier PO History

GET 
/api/reporting/suppliers/:supplier/po-history

Recent purchase orders for one supplier — backs the "Recent Purchase Orders" mini-table on the supplier Analytics tab. Returns up to the 10 most recent non-draft purchase orders ordered by purchase order date (DESC), each with its receipt status and an on-time flag.

Authentication: Requires Bearer token (scope: reports)

Path parameters:

  • supplier: the Supplier ID

This endpoint is period-independent — it always returns the most recent purchase orders and takes no query parameters. Draft purchase orders are excluded.

Response fields per row:

  • id: purchase order ID
  • po_number: human-readable purchase order number
  • purchase_order_date: order date (Y-m-d)
  • total_cost: total purchase order cost
  • receipt_status: receipt status of the PO (e.g. unreceived, partially_received, fully_received)
  • on_time: true if fully received on or before the estimated delivery date, false if late, null if not yet fully received

Request​

Responses​

Successful response