PlatitunPlatitun · API · The deal · The order vaults
The order vaults
GET /api/v1/orders/{id}/handoverKey scope: orders · read only
The list of the order’s vaults: whose it is and whether it was opened. The SECRETS THEMSELVES are not in this list — neither yours nor the buyer’s.
Response fields
| Field | Type | What it is |
|---|---|---|
items[].id | string | The vault id. |
items[].mine | boolean | Your vault or the buyer’s. |
items[].openedAt | string|null | When it was opened. Empty — not yet. |
Refusal reasons
A rule refusal arrives as {"error":"rejected","refusal":{"kind":"…"}} with status 409. Refusals common to all endpoints are in the rules section.
| Code | What happened and what to do |
|---|---|
not_found | The record does not exist or is not yours. The ownership condition is in the database query itself, so someone else’s record looks like a missing one. |
Nearby in this section
GET /api/v1/orders— My ordersGET /api/v1/orders/{id}— One orderPOST /api/v1/orders/{id}/confirm— Take the orderPOST /api/v1/orders/{id}/decline— Decline the orderPOST /api/v1/orders/{id}/deliver— Mark the deliveryPOST /api/v1/orders/{id}/messages— Message the buyerPOST /api/v1/orders/{id}/handover— Put credentials into a vaultPOST /api/v1/orders/{id}/handover/reveal— Read the buyer’s vaultPOST /api/v1/orders/{id}/dispute/reply— Answer a disputeGET /api/v1/reviews— Reviews about mePOST /api/v1/reviews/{id}/reply— Reply to a reviewGET /api/v1/complaints— My complaintsPOST /api/v1/complaints— Complain about a buyerGET /api/v1/work-mode— Work mode and presencePUT /api/v1/work-mode— Set the work mode