Platitun · API · Listings · My listings

My listings

GET /api/v1/listings

Key scope: listings · read only

All your listings with price, stock and state. Someone else’s never appear here: the ownership condition is in the database query itself, not checked afterwards.

Query filters

Field	Type	What it is
`active`	`boolean`	Only switched on (true) or only switched off (false).
`service`	`string`	Only for this catalogue position.
`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[].number`	`integer`	The public listing number.
`items[].priceMinor`	`integer`	The price in kopecks.
`items[].isActive`	`boolean`	On the storefront or withdrawn.
`items[].isTest`	`boolean`	A test listing: only a test buyer can buy it.
`items[].stock`	`integer\|null`	The remaining stock. Empty — the stock is unlimited.
`items[].autoIssue`	`boolean`	Whether the stock delivers on its own.
`nextCursor`	`string\|null`	The next page cursor. Empty — this is the last page.

Nearby in this section

POST /api/v1/listings — Create a listing
GET /api/v1/listings/{number} — One of my listings
PATCH /api/v1/listings/{number} — Update a listing
DELETE /api/v1/listings/{number} — Remove a listing
POST /api/v1/listings/{number}/state — Switch on, switch off, auto-delivery
POST /api/v1/listings/{number}/copy — Copy a listing
POST /api/v1/listings/{number}/test — Mark a listing as test
PUT /api/v1/listings/{number}/image — The listing image
DELETE /api/v1/listings/{number}/image — Remove the image
GET /api/v1/questions — Questions about my listings
POST /api/v1/questions/{id}/answer — Answer a question