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
idpath parameter. - Returns only seller-owned listings with
quantity > 0. - Returns
404if 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 = truewhen one or more units are currently held.
Failure behavior:
- Returns
400if the listing exists but its associated item can no longer be resolved.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Listing ID
Response
Listing
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