Find and Update Listings

Finding a Listing

In order to get the link to update one of your listings, first find it by SKU.

curl -XGET 
-H "Content-Type: application/hal+json" 
-H "Accept: application/hal+json" 
-H "Accept-Version: 3.0" 
-H "Authorization: Bearer [personal_token]"
https://api.reverb.com/api/my/listings?sku=[sku]&state=all

Please note the use of the state=all filter, which enables you to find drafts. By default, without this filter, the search will only find live listings.

You can also get listing details using the listing ID:

curl -XGET 
-H "Content-Type: application/hal+json" 
-H "Accept: application/hal+json" 
-H "Accept-Version: 3.0" 
-H "Authorization: Bearer [personal_token]"
https://api.reverb.com/api/listings/[listing_id]

Update an Existing Listing

Updating a listing takes the same parameters as the create, but uses a PUT request.

curl -XPUT 
-H "Content-Type: application/hal+json" 
-H "Accept: application/hal+json" 
-H "Accept-Version: 3.0" 
-H "Authorization: Bearer [personal_token]"
https://api.reverb.com/api/listings/[listing_id] 
--data-raw "..."

Publishing a Listing

In order to publish a listing, use this cURL request:

curl -XPUT 
-H 'Accept-Version: 3.0' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer [personal_token]' \
https://api.reverb.com/api/listings/[listing_id] \
--data-raw '{
    "publish": "true"
}'

This can also be included in the initial draft creation POST to publish the item right away.

Ending a Listing

How to transition a live listing to ended:

curl -XPUT 
-H "Content-Type: application/hal+json" 
-H "Accept: application/hal+json" 
-H "Accept-Version: 3.0" 
-H "Authorization: Bearer [personal_token]"
https://api.reverb.com/api/my/listings/[listing_id]/state/end 
--data-raw '{
"reason":"not_sold"/"reverb_sale"
}'

Please note the reason reverb_sale should be used in instances you found your buyer on Reverb, but the money transaction happened in person and cash was exchanged. This means, the selling fee will be charged on your monthly bill.