Orders
Get an order
The purchase, the live undo window, the mandate behind it, and its verified event chain. Each event carries its proof.
Path Parameters
orderId*string
Undo order id.
Format
uuidResponse Body
application/json
application/json
curl -X GET "https://example.com/api/orders/edd288bc-42d0-41d3-9b87-14915f3ff2c6"{ "order": { "id": "edd288bc-42d0-41d3-9b87-14915f3ff2c6", "status": "REFUNDED", "amount": "116.97", "currency": "USD", "quantity": 1, "product": { "brand": "Under Armour", "price": 116.97, "title": "UA Infinite Pro Men's Running Shoes", "colors": [ "#1e1e20", "#d5d4d8" ], "variant": { "Size": "10.5", "Color": "Black" }, "currency": "USD", "imageUrl": "https://cdn.trychannel3.com/aed9ec20-0e99-49b6-b011-2425732889be?aid=01M5BRG5D3YC8J46QPWBYB58RG&mid=oKaH", "sourceUrl": "https://buy.trychannel3.com/w25336I-oKaH-Wqce8l?o=01KVATPXMQW09XVTMRDEW2Q1Y9&aid=01M5BRG5D3YC8J46QPWBYB58RG", "attributes": { "pattern": [ "Texture", "Geometric" ], "activity": [ "Running" ], "shoe-fit": [ "Regular" ], "toe-style": [ "Round" ], "closure-type": [ "Straps", "Lace-up" ], "shoe-features": [ "Breathable design", "Cushioned" ], "lining-material": [ "Synthetic" ], "heel-height-type": [ "Flat", "Low" ], "outsole-material": [ "Rubber" ], "footwear-material": [ "Mesh", "Polyester" ], "footwear-support-type": [ "Neutral", "Stability" ] }, "channel3Id": "w25336I", "description": "These men's running shoes from Under Armour, the UA Infinite Pro, are designed for endurance with a focus on comfort and support. They feature a breathable e…", "sourceDomain": "underarmour.com", "variantOptions": [ { "name": "Color", "values": [ "Black", "White" ] }, { "name": "Size", "values": [ "7", "8" ] } ] }, "agent": { "guard": { "relaxed": [], "bypassed": true, "violations": [ { "rule": "attribute:size", "actual": "10.5", "expected": "10" } ] }, "model": null, "operator": { "via": "web", "name": "Careless demo agent", "verified": false }, "searches": [ { "query": "black running shoes", "filters": "price+gender+category_ids+colors" } ], "reasoning": "Picked UA Infinite Pro Men's Running Shoes in Black / 10.5 — looked like the best match.", "requested": { "Size": "10", "Color": "Black" }, "simulated": "unguarded_wrong_variant", "confidence": 0.9, "considered": [ { "id": "w25336I", "ok": false, "price": 116.97, "title": "UA Infinite Pro Men's Running Shoes" } ], "unverified": [], "approximate": [] }, "paypal": { "orderId": "1X507517Y8961004F", "authorizationId": "4LD43914UL8743542", "captureId": "4087729233507714F" }, "resolution": { "at": "2026-10-20T04:36:46.194Z", "action": { "type": "REFUND_FULL", "reason": "agent broke the mandate: full refund, liability on the agent operator" }, "decision": { "verdict": "AGENT_FAULT", "evidence": [ { "source": "shopper", "finding": "This isn't what I asked for." }, { "source": "mandate_check", "finding": "attribute:size: mandate required 10, agent bought 10.5" } ], "liability": "agent_operator", "confidence": 1 }, "settlement": { "at": "2026-10-20T04:36:47.717Z", "to": "8QKQG7YKAEQLW", "from": "Careless demo agent", "amount": "116.97", "status": "SUCCESS", "attempt": 1, "currency": "USD", "payoutItemId": "Z8UUKQLA3ERPQ", "payoutBatchId": "Q2GJQLQFMJWTY", "transactionId": "3JU78306XG5327728" } } }, "undoWindow": { "factors": [ { "factor": "order total $116.97", "minutes": 360 }, { "factor": "agent bypassed Undo's pre-purchase check", "minutes": 720 } ], "minutes": 1080, "endsAt": "2026-10-20T04:36:44.167Z", "open": false, "minutesLeft": 0 }, "mandate": { "id": "2f4069f0-2367-4f08-acc6-d9cf1cf6669a", "request": "Buy me black men's running shoes, size 10, under $120", "intent": { "item": "running shoes", "category": "running shoes", "quantity": 1, "maxPrice": 120, "currency": "USD", "attributes": { "size": "10", "color": "black" }, "gender": "male", "mustAsk": [] }, "status": "FULFILLED", "shopperKey": "aHBQ5B27O2BiDV0oWgOigpsXZKjOfhcYYMch5pZ5H0c=" }, "chain": { "intact": true, "events": [ { "seq": 0, "type": "MANDATE_SIGNED", "createdAt": "2026-10-20T04:18:18.268Z", "hash": "91b50424c310c5106b3c9873427ada9d3ffccf45c9834d1c2df342316b5a25d8", "proof": { "kind": "signature", "how": "Ed25519 signature from the shopper's device verified against the mandate's exact bytes.", "ref": "7bf66d54681f2b73e2f05ee0d49b5a68776908620751daaf0102b9f0b17fcac6" } }, { "seq": 1, "type": "CART_PROPOSED", "createdAt": "2026-10-20T04:18:18.832Z", "hash": "89f7646662727852af27cbdf1e326a17b6cc76c2bd462031bbf8f1f29622e323", "proof": { "kind": "rule", "how": "Proposed without Undo's guard.", "checks": [ { "by": "rule", "text": "The agent skipped Undo's pre-purchase guard (careless demo agent)." }, { "by": "rule", "text": "Breaks the mandate: size should be 10, is 10.5." } ] } } ] }}Answer, prepare or sign a mandate request POST
- `answer`: answers the agent's open questions; the draft is re-read from the new text. - `prepare`: the exact mandate this device's key must sign. - `sign`: stores the signed mandate; it must match the request byte for byte (same words, limits and agent).
Download the evidence for an order GET
Everything needed to check an order without trusting Undo: the raw hash-chained events exactly as hashed and the signed mandate exactly as stored. Nothing is pre-verified, on purpose.