List Purchase Orders

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

GET /api/v1/purchase-orders

cURL

curl 'https://api.stateset.com/api/v1/purchase-orders?status=IN_PRODUCTION&limit=50' \
  -H 'Authorization: Bearer <token>'

200

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

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

supplier_id · string

Only purchase orders to this supplier.

status · string

Filter by purchase order status.

limit · integer

Page size.

offset · integer

Number of results to skip.

after · string

Opaque cursor for keyset pagination — pass the previous response’s next_cursor.

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.

Response

data · array · required

The purchase orders, each shaped as in Get Purchase Order.

has_more · boolean · required

Whether further pages exist.

next_cursor · string

Cursor for the next page. Absent on the last page.

cURL

curl 'https://api.stateset.com/api/v1/purchase-orders?status=IN_PRODUCTION&limit=50' \
  -H 'Authorization: Bearer <token>'

200

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

Related

• Get Purchase Order
• Create Purchase Order
• Finance Purchase Order