List Purchase Orders

{
  "data": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "poNumber": "PO-2026-001234",
      "supplierId": "SUP-001",
      "supplierCode": "ACME-CORP",
      "supplierName": "ACME Corporation",
      "poDate": "2026-02-10T19:58:00.00Z",
      "dueDate": "2026-03-12T00:00:00.00Z",
      "status": "Open",
      "currencyCode": "USD",
      "totalAmount": 15750,
      "terms": "Net 30",
      "buyerName": "John Smith",
      "lineCount": 2
    },
    {
      "id": "223e4567-e89b-12d3-a456-426614174001",
      "poNumber": "PO-2026-001235",
      "supplierId": "SUP-002",
      "supplierCode": "WIDGETS-INC",
      "supplierName": "Widgets Incorporated",
      "poDate": "2026-02-09T14:30:00.00Z",
      "dueDate": "2026-03-09T00:00:00.00Z",
      "status": "Partial",
      "currencyCode": "USD",
      "totalAmount": 1,
      "terms": "Net 60",
      "buyerName": "Jane Doe",
      "lineCount": 3
    },
    {
      "id": "323e4567-e89b-12d3-a456-426614174002",
      "poNumber": "PO-2026-001236",
      "supplierId": "SUP-003",
      "supplierCode": "SUPPLY-CO",
      "supplierName": "Supply Company LLC",
      "poDate": "2026-02-08T09:15:00.00Z",
      "dueDate": "2026-02-22T00:00:00.00Z",
      "status": "Open",
      "currencyCode": "USD",
      "totalAmount": 3250,
      "terms": "Net 30",
      "buyerName": "John Smith",
      "lineCount": 1
    }
  ],
  "pagination": {
    "total": 3,
    "limit": 100,
    "offset": 0,
    "hasMore": false
  }
}

Retrieves a paginated list of purchase orders with optional filtering by status, supplier, date range, and other criteria. Returns a summary view of each purchase order.

Query parameters

limitintegerOptional

Maximum number of records to return (default: 100, max: 1000)

offsetintegerOptional

Number of records to skip for pagination (default: 0)

statusstringOptional

Filter by PO status (Open, Closed, Cancelled, Partial)

supplierIdstringOptional

Filter by supplier ID

startDatestringOptional

Filter POs created on or after this date (ISO 8601 format)

endDatestringOptional

Filter POs created on or before this date (ISO 8601 format)

Response

Success Response

datalist of objectsOptional

paginationobjectOptional