Platitun · API · The deal · My orders

My orders

GET /api/v1/orders

Key scope: orders · read only

Orders for your listings. The main filter is needsAction: it returns the ones where the move is yours, and you can run your work by it alone. The updatedSince filter is the fallback for webhooks: it is always there and survives any delivery failure.

Who bought is NOT named — no email, no nickname. The marketplace does not show this to the seller in the cabinet either.

Query filters

Field	Type	What it is
`needsAction`	`boolean`	Only the ones where the move is yours: awaiting confirmation, awaiting delivery, dispute open.
`status`	`string`	Only in this state.
`updatedSince`	`string`	Changed after this time. A UTC string.
`limit`	`integer`	How many records to return. Default 50, maximum 200.
`cursor`	`string`	The nextCursor value from the previous response. There are no page numbers: the list changes while you page.

Response fields

Field	Type	What it is
`items`	`array`	The records of this page.
`items[].id`	`string`	The order id.
`items[].status`	`string`	The order state.
`items[].amountMinor`	`integer`	The amount in kopecks — a snapshot taken at order time.
`items[].listing`	`integer`	The listing number.
`items[].deadlineAt`	`string\|null`	Until when the move is yours.
`nextCursor`	`string\|null`	The next page cursor. Empty — this is the last page.

Nearby in this section

GET /api/v1/orders/{id} — One order
POST /api/v1/orders/{id}/confirm — Take the order
POST /api/v1/orders/{id}/decline — Decline the order
POST /api/v1/orders/{id}/deliver — Mark the delivery
POST /api/v1/orders/{id}/messages — Message the buyer
GET /api/v1/orders/{id}/handover — The order vaults
POST /api/v1/orders/{id}/handover — Put credentials into a vault
POST /api/v1/orders/{id}/handover/reveal — Read the buyer’s vault
POST /api/v1/orders/{id}/dispute/reply — Answer a dispute
GET /api/v1/reviews — Reviews about me
POST /api/v1/reviews/{id}/reply — Reply to a review
GET /api/v1/complaints — My complaints
POST /api/v1/complaints — Complain about a buyer
GET /api/v1/work-mode — Work mode and presence
PUT /api/v1/work-mode — Set the work mode