--- title: "List listings by item" method: GET path: "/seller/listings/items" tags: ["seller-listings"] --- # List listings by item `GET /seller/listings/items` List the authenticated seller's active listings for a specific item URN. This endpoint is useful for item-centric listing management screens where a seller wants all of their offers for one product. Query and ownership rules: - Requires `urn` query parameter. - Returns only listings owned by the authenticated seller. - Returns only listings with `quantity > 0` (active listings). Data sources: - Listing rows are loaded from the primary database. - Item metadata is enriched from the catalog search index. - Listing lock state is derived from listing hold records. - Attachment URLs are attached to each listing in the response. Response notes: - If no active listings exist for the provided URN, the API returns an empty array. - The `available` quantity in this response mirrors listing quantity. ## Query parameters - `urn` string, required — URN of the item to retrieve listings for ## Response `200` Listings for item - object[] — Listings for a specific item owned by the authenticated seller - `id` string, required - `sellerId` string, required - `condition` string, required — Product condition - `price` integer, required — Price in pence - `quantity` integer — Total quantity for this listings - `available` integer — Total available for this listing - `language` string, required — Languages of the card - `variants` string[] — Variants of the listed card - `comment` string, nullable — Seller's comment about the listing - `gradingProvider` string, nullable — Provider responsible for grading the card - `gradingScore` string, nullable — Score assigned to the card by the grading provider - `gradingNumber` string, nullable — Certificate or registration number issued by the grading provider - `createdAt` union, required — Timestamp when the listing was created - string - string, date-time - `updatedAt` union, required — Timestamp when the listing was last updated - string - string, date-time - `item` union, required — Details of the item being listed - object - `urn` string, required - `type` 'card', required - `game` 'Pokemon', required - `title` string, required - `name` string, required - `rarity` string, required - `number` string, nullable - `description` string - `set` object, required - `name` string, required - `size` number - `urn` string, required - `counts` object, required - `printed` number - `total` number - `symbol` object - `url` string, required - `released` string - `references` string[], required - `series` object, required - `name` string, required - `urn` string, required - `images` object[], required - `urn` string, required - `illustrator` string - `orientation` 'portrait' | 'landscape', required - `url` string, uri, required - `alternatives` string[], required - `metadata` object[], required - `name` string, required - `value` union - string - string[] - number - number[] - `detail` union - unknown - unknown[] - unknown - `price` integer - `available` integer — Total available for this listing - `quantity` integer — Total quantity available - `min` object - `price` integer, nullable, required — Price of the cheapest listing in pence - `max` object - `price` integer, nullable, required — Price of the most expensive listing in pence - object - `urn` string, required - `type` 'product', required - `game` 'Pokemon', required - `title` string, required - `name` string, required - `classification` 'CARD', required - `count` number, required - `description` string - `images` object[], required - `urn` string, required - `illustrator` string - `orientation` 'portrait' | 'landscape', required - `url` string, uri, required - `series` object, required - `name` string, required - `urn` string, required - `set` object, required - `name` string, required - `size` number - `urn` string, required - `counts` object, required - `printed` number - `total` number - `symbol` object - `url` string, required - `released` string - `references` string[], required - `metadata` object[], required - `name` string, required - `value` union - string - string[] - number - number[] - `detail` union - unknown - unknown[] - unknown - `price` integer - `available` integer — Total available for this listing - `quantity` integer — Total quantity available - `min` object - `price` integer, nullable, required — Price of the cheapest listing in pence - `max` object - `price` integer, nullable, required — Price of the most expensive listing in pence - `seller` object, required — Seller of the listing - `id` string, required — Unique identifier for the user - `username` string, required — Public username of the user - `joined` string, date-time — ISO timestamp when the user account was created - `avatar` string, uri — URL to the user's avatar image - `cover` string, uri — URL to the user's cover image - `profile` string — Information about the user - `reviews` integer, required — Total number of reviews the user has received - `rating` number, required — Confidence-based rating between 0 and 5 - `score` number, required — Average rating between 0 and 5 - `sales` integer, required — Total number of sales the user has made - `purchases` integer, required — Total number of purchases the user has made - `locked` boolean, required — True when the listing has active item holds - `attachments` ListingAttachment[] — Image attachments for the listing - `id` string, required — Image identifier - `url` string, uri, required — Public URL for the attachment - `valid` boolean, required — True when the listing meets all requirements - `hidden` boolean, required — True when the listing is hidden from buyers - `notes` string, nullable — Private notes for the seller such as SKUs or storage locations - `reference` string, nullable — Third-party integration reference for this listing --- [API](https://skmtc.net/managem/apis/managem-api.md) · [All operations](https://skmtc.net/managem/apis/managem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/managem/managem-api/versions/6367b514f6ea/schema)