v14

OpenAPI 3.1.02026-08-03122113375.9 KB
seller-listings

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 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.
get/seller/listings/items

Query parameters

urnstring required

URN of the item to retrieve listings for

URN of the item to retrieve listings for

Response

Listings for item

idstring required
sellerIdstring required
conditionstring required

Product condition

priceinteger required

Price in pence

quantityinteger

Total quantity for this listings

availableinteger

Total available for this listing

languagestring required

Languages of the card

variantsstring[]

Variants of the listed card

commentstring nullable

Seller's comment about the listing

gradingProviderstring nullable

Provider responsible for grading the card

gradingScorestring nullable

Score assigned to the card by the grading provider

gradingNumberstring nullable

Certificate or registration number issued by the grading provider

lockedboolean required

True when the listing has active item holds

validboolean required

True when the listing meets all requirements

hiddenboolean required

True when the listing is hidden from buyers

notesstring nullable

Private notes for the seller such as SKUs or storage locations

referencestring nullable

Third-party integration reference for this listing