Update fields on an existing seller-owned listing.
Use this endpoint for partial updates such as price changes, quantity adjustments, visibility toggles, notes, and grading metadata.
Authorization and state rules:
423.Validation:
gradingProvider, gradingScore, and gradingNumber must be provided together.notes is optional, normalized by the API, and limited to 255 characters.Validity recalculation:
valid during update.>= 2000 or containing grading metadata require at least one attachment.valid is set to false.Side effects:
LISTING_UPDATED webhook events after a successful update.Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Listing ID
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
255Listing
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
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
255