List purchase orders

GET 
/purchase-orders

Returns a paginated list of purchase orders across all vendors. Each PO includes line items, financial totals, delivery dates, and current status. Filter by status, vendor, or date range to find specific orders. PO statuses progress from draft through sent, accepted, and shipped to completed, with partially_received, cancelled, and delayed as additional states.

Request

Response

200

Paginated purchase orders

400

Bad request — invalid parameters

401

Unauthorized — missing or invalid API key

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
  }
}