marketplace

GET `/v1/marketplace/orders/{sale_id}`

The order workspace — one order, from your side of it.

Pagpapatotoo

Magpadala ng API key bilang bearer token. Ang endpoint na ito ay hindi naglatag ng tiyak na pahintulot sa pagtutukoy, kaya ibigay sa iyong key ang pinakamababang kailangan nito at suriin ang tugon sa halip na umasa.

Ang endpoint na ito ay hindi nangangailangan ng id ng organisasyon. Natutukoy na ng iyong key ang organisasyong kinabibilangan nito, at nakatuon ang tugon dito.

Subukan ito

Palitan ang anuman sa loob ng mga panaklong na may anggulo ng iyong sariling mga halaga, at ang placeholder ng key na may key mula sa iyong dashboard.

curl -X GET https://api.zinndigital.com/v1/marketplace/orders/{sale_id} \
  -H "Authorization: Bearer zdk_live_…"

Nakalagda? Ang API console sa iyong dashboard ay awtomatikong naglalagay ng iyong tunay na ID ng organisasyon at sariling susi, at pinapatakbo ang kahilingan laban sa live na API upang makita mo ang aktwal na tugon. Buksan ang endpoint na ito sa console ng API

Mga Detalye

docs/147 §3. The screen where the work actually happens, for whichever party is asking. Before this there was a buyer's list and a seller's money screen, and nowhere the work happened. The payload leads with `turn` and `waiting_on` because the screen does. The anti-jumble device is one question at the top — **whose turn is it, and what is it waiting for** — and it is computed in the engine so every client answers it identically rather than each deriving it from six columns. `paused` is the revision clock, made visible. Requesting a revision pauses the acceptance window by clearing its deadline, which is correct and completely unrenderable: a null deadline looks identical to a sale that never had one. The commission split is present for the SELLER and null for the buyer. To a buyer the price is the price.

Mga Parameter

Pangalan	Uri	Kailangan	Ano ito
`sale_id (path)`	`string`	Oo	—

Tugon

Pangalan	Uri	Kailangan	Ano ito
`sale_id`	`string`	Oo	—
`state`	`string`	Oo	—
`archetype`	`MarketplaceOrderArchetype`	Oo	How this order behaves. Adding a CATEGORY is configuration; adding an ARCHETYPE is a build. Every order-side decision — whether a delivery clock exists, whether auto-accept appl…
`listing_title`	`string`	Hindi	—
`package_name`	`string`	Hindi	—
`turn`	`MarketplaceOrderTurn`	Oo	Whose move it is. `staff` is a real answer, not a fallback: a disputed order is genuinely waiting on us, and telling a buyer "waiting for the seller" while a moderator holds it…
`waiting_on`	`MarketplaceOrderWaitingOn`	Oo	What the order is waiting FOR — the half that makes `turn` actionable.
`is_yours`	`boolean`	Hindi	Whether the caller is the party being waited on.
`is_buyer`	`boolean`	Oo	—
`deadline`	`string`	Hindi	The clock that is actually running, or null when none is.
`paused`	`boolean`	Hindi	A clock EXISTS but is stopped — the revision pause. Distinct from a null deadline, which also covers an order that never had a clock at all.
`overdue`	`boolean`	Hindi	Never true while `delivery_due_at` is null: null means the clock has not started, which is exactly the state of an order whose buyer has not written their brief yet.
`handover_confirmed`	`integer`	Hindi	—
`handover_required`	`integer`	Hindi	—
`outstanding`	`string[]`	Hindi	Question keys the buyer still owes.
`revisions_used`	`integer`	Hindi	—
`revisions_included`	`integer`	Hindi	—
`delivery_due_at`	`string`	Hindi	—
`currency`	`string`	Hindi	—
`gross_minor`	`integer`	Hindi	Integer minor units. Money is never a float.
`commission_minor`	`integer`	Hindi	The platform's commission, as its own figure. Present for the SELLER and null for the buyer — to a buyer the price is the price. The platform is merchant of record on every mark…
`vendor_net_minor`	`integer`	Hindi	What we owe the seller — a trade payable, not money held on trust.
`requirements_schema`	`object[]`	Hindi	The questions AS ASKED, frozen at purchase. A seller who rewrites their questions tomorrow cannot change what this buyer was asked.
`requirements`	`object`	Hindi	The buyer's answers, in the same `{key: {v: …}}` envelope.
`requirements_submitted_at`	`string`	Hindi	—
`handover_items`	`MarketplaceHandoverItem[]`	Hindi	—
`last_revision_reason`	`string`	Hindi	—

Mga error na maibabalik ng endpoint na ito

401 · 404

GET /v1/marketplace/orders/{sale_id}