Skip to main content

Get item purchasing history

GET 
/items/:itemId/purchasing-history

Returns every purchase order that includes this item, with the ordered quantity, received quantity, outstanding quantity, and line-level fulfillment status (pending, partially_received, or fully_received). Use this to track vendor delivery performance, identify overdue shipments, or audit receipt history. Filter by date range, vendor, or fulfillment status.

Request​

Response​

Purchasing history

Response
{
  "data": [
    {
      "purchaseOrderNumber": "PO-2025-0471",
      "vendorId": null,
      "vendorName": "Pacific Ingredients Co.",
      "orderDate": "2025-03-15",
      "expectedDeliveryDate": "2025-03-22",
      "status": "completed",
      "quantityOrdered": 200,
      "quantityReceived": 200,
      "outstandingQuantity": 0,
      "unit": "lbs",
      "unitPrice": 3.25,
      "lineStatus": "fully_received"
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 20,
    "total": 87
  }
}