v14

latestOpenAPI 3.1.02026-08-03122113375.9 KB
seller-listings

Get listing

Retrieve one active listing owned by the authenticated seller.

Use this endpoint for listing detail pages and edit forms.

Lookup rules:

  • Requires listing id path parameter.
  • Returns only seller-owned listings with quantity > 0.
  • Returns 404 if the listing does not exist or does not belong to the caller.

Response enrichment:

  • Joins item metadata from the catalog index.
  • Includes seller summary and attachment URLs.
  • Computes hold-aware availability:
    • available = quantity - heldQuantity.
    • locked = true when one or more units are currently held.

Failure behavior:

  • Returns 400 if the listing exists but its associated item can no longer be resolved.
get/seller/listings/{id}

Path parameters

idstring required

Listing ID

Listing ID

Response

Listing

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