PlatitunPlatitun · API · Listings · One of my listings
One of my listings
GET /api/v1/listings/{number}Key scope: listings · read only
Every listing field as the marketplace sees it — including the product attributes the storefront ordering is computed from.
Response fields
| Field | Type | What it is |
|---|---|---|
number | integer | The public number. |
filled | integer | How many product attributes are filled — the buyer sees how thoroughly the product is described. |
stockFree | integer|null | How many stock units are free. |
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/listings— My listingsPOST /api/v1/listings— Create a listingPATCH /api/v1/listings/{number}— Update a listingDELETE /api/v1/listings/{number}— Remove a listingPOST /api/v1/listings/{number}/state— Switch on, switch off, auto-deliveryPOST /api/v1/listings/{number}/copy— Copy a listingPOST /api/v1/listings/{number}/test— Mark a listing as testPUT /api/v1/listings/{number}/image— The listing imageDELETE /api/v1/listings/{number}/image— Remove the imageGET /api/v1/questions— Questions about my listingsPOST /api/v1/questions/{id}/answer— Answer a question