curl 'https://api.stateset.com/v1/purchaseorder/po_67890' \
-H 'Authorization: Bearer <token>'
{
"purchase_order_id": "po_67890",
"status": "IN_PRODUCTION",
"supplier_id": "did:stateset:supplier:xyz789",
"buyer_id": "did:stateset:buyer:abc123",
"amount": "100000.00",
"currency": "USDC",
"delivery_terms": {
"incoterm": "FOB",
"expected_delivery": "2024-08-15"
},
"financing": {
"financing_id": "pof_9x3kLm8nR5",
"advance_amount": "80000.00",
"funding_schedule": [
{ "milestone": "ORDER_CONFIRMED", "amount": "40000.00", "funded_at": "2024-06-25T12:10:00Z" },
{ "milestone": "PRODUCTION_COMPLETE", "amount": "40000.00", "estimated_date": "2024-08-01" }
],
"repayment_due": "2024-10-15"
}
}
Get Purchase Order
Retrieve a purchase order with its line items, delivery terms, and financing state.
GET
/
v1
/
purchaseorder
/
{id}
curl 'https://api.stateset.com/v1/purchaseorder/po_67890' \
-H 'Authorization: Bearer <token>'
{
"purchase_order_id": "po_67890",
"status": "IN_PRODUCTION",
"supplier_id": "did:stateset:supplier:xyz789",
"buyer_id": "did:stateset:buyer:abc123",
"amount": "100000.00",
"currency": "USDC",
"delivery_terms": {
"incoterm": "FOB",
"expected_delivery": "2024-08-15"
},
"financing": {
"financing_id": "pof_9x3kLm8nR5",
"advance_amount": "80000.00",
"funding_schedule": [
{ "milestone": "ORDER_CONFIRMED", "amount": "40000.00", "funded_at": "2024-06-25T12:10:00Z" },
{ "milestone": "PRODUCTION_COMPLETE", "amount": "40000.00", "estimated_date": "2024-08-01" }
],
"repayment_due": "2024-10-15"
}
}
Overview
Returns the PO and, if it has been financed, the state of that financing — including which funding milestones have released.Path
string
required
The purchase order identifier, e.g.
po_67890.Response
string
required
PO identifier.
string
required
DRAFT, REQUESTED, APPROVED, IN_PRODUCTION, COMPLETE, or CANCELLED.string
required
Buyer DID.
string
required
Total PO value.
string
required
USDC or ssUSD.array
required
What was ordered — SKU, quantity, and unit price per line.
object
required
Incoterm, expected delivery date, and delivery address.
object
Present only if the PO has been financed.
Errors
Succeeds with200. Failures return 400, 401, 403, 404 or 429 with an error body, per the platform status-code contract.
curl 'https://api.stateset.com/v1/purchaseorder/po_67890' \
-H 'Authorization: Bearer <token>'
{
"purchase_order_id": "po_67890",
"status": "IN_PRODUCTION",
"supplier_id": "did:stateset:supplier:xyz789",
"buyer_id": "did:stateset:buyer:abc123",
"amount": "100000.00",
"currency": "USDC",
"delivery_terms": {
"incoterm": "FOB",
"expected_delivery": "2024-08-15"
},
"financing": {
"financing_id": "pof_9x3kLm8nR5",
"advance_amount": "80000.00",
"funding_schedule": [
{ "milestone": "ORDER_CONFIRMED", "amount": "40000.00", "funded_at": "2024-06-25T12:10:00Z" },
{ "milestone": "PRODUCTION_COMPLETE", "amount": "40000.00", "estimated_date": "2024-08-01" }
],
"repayment_due": "2024-10-15"
}
}
A tranche with
estimated_date and no funded_at has not released. Milestone funding is gated
on the milestone actually being reached — treat the estimate as a forecast, not a commitment.Related
Last modified on August 29, 2026