List listings by item
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
urnquery 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
availablequantity in this response mirrors listing quantity.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
URN of the item to retrieve listings for
Response
Listings for item
Product condition
Price in pence
Languages of the card
Timestamp when the listing was created
Timestamp when the listing was last updated
Details of the item being listed
- Option 1
- Option 2
Seller of the listing
True when the listing has active item holds
True when the listing meets all requirements
True when the listing is hidden from buyers
Total quantity for this listings
Total available for this listing
Variants of the listed card
Seller's comment about the listing
Provider responsible for grading the card
Score assigned to the card by the grading provider
Certificate or registration number issued by the grading provider
Image attachments for the listing
Private notes for the seller such as SKUs or storage locations
255Third-party integration reference for this listing
255