Reverb

Welcome to the Reverb API

Welcome to the Reverb developer hub. You'll find comprehensive guides and documentation to help you start working with Reverb as quickly as possible, as well as support if you get stuck.

Get Started

1. Add Listings To A Sale

/api/sales/:sale_id/listings

You can add up to 25 listings at a time by passing an Array of listing_ids. You must be a Reverb Preferred Seller to access this endpoint.

curl -XPOST -H "Content-Type: application/hal+json" -H "Accept: application/hal+json" -H "Authorization: Bearer [oauth_token]" -H "Accept-Version: 3.0" https://api.reverb.com/api/sales/89472/listings -d '{"listing_ids":["21363","24524"]}'
{"results":[
  {
    "listing_id":"21363",
    "success":true,
    "message":"OK"
  },
  {
    "listing_id":"24524",
    "success":false,
    "message":"You are not authorized to add this listing to a sale." // example error message
  }
]}

2. Remove Listings From A Sale

/api/sales/:sale_id/listings

You can remove up to 25 listings at a time by passing an Array of listing_ids. You must be a Reverb Preferred Seller to access this endpoint.

curl -XDELETE -H "Content-Type: application/hal+json" -H "Accept: application/hal+json" -H "Accept-Version: 3.0" -H "Authorization: Bearer [oauth_token]" https://api.reverb.com/api/sales/89472/listings -d '{"listing_ids":["21363","24524"]}'
{"results":[
  {
    "listing_id":"21363",
    "success":true,
    "message":"OK"
  },
  {
    "listing_id":"24524",
    "success":false,
    "message":"You are not authorized to remove this listing from a sale." // example error message
  }
]}

3. View All Sales for a Given Listing

/api/listings/:listing_id/sales

Authentication not required; however, an authenticated user may see more information.

curl -XGET -H "Authorization: Bearer [oauth_token]" -H "Accept-Version: 3.0" https://api.reverb.com/api/listings/21363/sales
{
  "total":1,
  "_links":{},
  "sales":[
    {
     "id":5,
     "discount_percent":10,
     "discount_code":"10PERCENT",
     "max_count_listings_allowed":null,
      "starts_at":"2015-12-25T08:00:00-06:00",
      "ends_at":"2016-01-22T11:50:50-06:00",
      "_links":{
        "web":{
          "href":"https://reverb.site/sales/feil-group-old-sale"
        },
        "listings":{
          "href":"/api/sales/5/listings"
        }
      }
    }
  ]
}

4. View All Reverb Official Sales

/api/sales/reverb

View all live and upcoming Reverb Official Sales. You must be a Reverb Preferred Seller to access this endpoint.

curl -XGET -H "Authorization: Bearer [oauth_token]" -H "Accept-Version: 3.0" https://api.reverb.com/api/sales/reverb
{
  "total":1,
  "_links":{},
  "sales":[
    {
      "id":2,
      "discount_percent":5,
      "discount_code":"REVERBrules",
      "max_count_listings_allowed":20,
      "starts_at":"2015-12-30T08:00:00-06:00",
      "ends_at":"2016-01-21T18:00:00-06:00",
      "_links":{
        "web":{
          "href":"https://reverb.site/sales/reverb-pedal-sale"
        },
        "listings":{
          "href":"/api/sales/2/listings"
        }
      }
    }
  ]
}

5. View all your Seller Sales

/api/sales/seller

View all sales that you own. You must be a Reverb Preferred Seller to access this endpoint.

curl -XGET -H "Authorization: Bearer [oauth_token]" -H "Accept-Version: 3.0" https://api.reverb.com/api/sales/seller
{
  "total":2,
  "_links":{},
  "sales":[
    {
     "id":5,
     "discount_percent":10,
     "discount_code":"10PERCENT",
     "max_count_listings_allowed":null,
      "starts_at":"2015-12-25T08:00:00-06:00",
      "ends_at":"2016-01-22T11:50:50-06:00",
      "_links":{
        "web":{
          "href":"https://reverb.site/sales/feil-group-old-sale"
        },
        "listings":{
          "href":"/api/sales/5/listings"
        }
      }
    }
  ]
}

Notes on Sale Attributes

  • max_count_listings_allowed is an Integer denoting how many listings are allowed in a Sale per user. This is typically only set on Reverb Official Sales, and is irrelevant for Seller Sales. A null value indicates no threshold.