> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Purchase Orders

> List purchase orders, filtered by status, counterparty, or delivery window.

### Overview

Returns a page of purchase orders. The two queries that earn their keep are *what is in production*
and *what is due to deliver soon* — a PO slipping its delivery date is what puts financed tranches
at risk.

### Query

<ParamField query="supplier_id" type="string">
  Only purchase orders to this supplier.
</ParamField>

<ParamField query="status" type="string">
  Filter by purchase order status.
</ParamField>

<ParamField query="limit" type="integer">
  Page size.
</ParamField>

<ParamField query="offset" type="integer">
  Number of results to skip.
</ParamField>

<ParamField query="after" type="string">
  Opaque cursor for keyset pagination — pass the previous response's `next_cursor`.
</ParamField>

<Tip>
  This endpoint supports **both** offset and keyset pagination. Prefer `after`: keyset paging is stable
  while the underlying set changes, where `offset` can skip or repeat rows as purchase orders move
  through their lifecycle. Use `offset` only when you need to jump to an arbitrary page.
</Tip>

### Response

<ResponseField name="data" type="array" required>
  The purchase orders, each shaped as in
  [Get Purchase Order](/stateset-commerce-api-reference/purchaseorders/get).
</ResponseField>

<ResponseField name="has_more" type="boolean" required>
  Whether further pages exist.
</ResponseField>

<ResponseField name="next_cursor" type="string">
  Cursor for the next page. Absent on the last page.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl 'https://api.stateset.com/api/v1/purchase-orders?status=IN_PRODUCTION&limit=50' \
    -H 'Authorization: Bearer <token>'
  ```

  ```bash Next page, keyset theme={null}
  curl 'https://api.stateset.com/api/v1/purchase-orders?limit=50&after=cur_8y4mQr5oP2' \
    -H 'Authorization: Bearer <token>'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "purchase_order_id": "po_67890",
        "status": "IN_PRODUCTION",
        "supplier_id": "did:stateset:supplier:xyz789",
        "amount": "100000.00",
        "currency": "USDC",
        "delivery_terms": { "incoterm": "FOB", "expected_delivery": "2024-08-15" }
      }
    ],
    "has_more": false
  }
  ```
</ResponseExample>

### Related

* [Get Purchase Order](/stateset-commerce-api-reference/purchaseorders/get)
* [Create Purchase Order](/stateset-commerce-api-reference/purchaseorders/create)
* [Finance Purchase Order](/stateset-commerce-api-reference/purchaseorders/finance)