Skip to main content

Get vendor purchase orders

GET 
/vendors/:vendorId/purchase-orders

Returns the purchase order history for a specific vendor. Each PO includes line items, financial totals, delivery dates, and current status. Filter by date range or status to focus on active, overdue, or completed orders. Use this to audit spend with a supplier or review their delivery track record.

Request​

Response​

Paginated purchase orders

Response
{
  "data": [
    {
      "orderNumber": "PO-2025-0471",
      "vendorId": null,
      "vendorName": "Pacific Ingredients Co.",
      "invoiceDate": "2025-03-10",
      "expectedDeliveryDate": "2025-03-17",
      "status": "completed",
      "subtotal": 2800,
      "taxAmount": 224,
      "discount": 0,
      "shippingCost": 150,
      "totalAmount": 3174,
      "currency": "USD",
      "paymentTerms": "Net 30",
      "lineItems": [
        {
          "itemId": "2087",
          "itemName": "Organic Tahini",
          "description": null,
          "quantity": 200,
          "unit": "lbs",
          "unitPrice": 3.25,
          "totalPrice": 650,
          "taxRate": 0.08,
          "receivedQuantity": 200,
          "lineStatus": "fully_received"
        }
      ]
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 20,
    "total": 87
  }
}