Update listing
Update fields on an existing seller-owned listing.
Use this endpoint for partial updates such as price changes, quantity adjustments, visibility toggles, notes, reference metadata, and grading details.
Authorization and state rules:
- Caller must be an active seller.
- Listing must belong to the authenticated seller.
- Listing updates are blocked while active holds exist; locked listings return
423.
Validation:
- Request body is partial, but grading metadata must remain complete:
gradingProvider,gradingScore, andgradingNumbermust be provided together.
notesis optional, normalized by the API, and limited to 255 characters.referenceis optional integration metadata, normalized by the API, and limited to 255 characters.- Setting
reference: nullclears any previously stored value.
Validity recalculation:
- The API recalculates
validduring update. - Listings priced at
>= 2000or containing grading metadata require at least one attachment. - If photo requirements are not met,
validis set tofalse.
Side effects:
- Emits
LISTING_UPDATEDwebhook events after a successful update. - Returns the refreshed listing with item, seller, attachment metadata, and the normalized
referencevalue.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Listing ID
Body
Fields that can be updated on a listing
Product condition
Price in pence
Total quantity for this listings
Languages of the card
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
True when the listing is hidden from buyers
Private notes for the seller such as SKUs or storage locations
255Third-party integration reference for this listing
255Response
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