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

Create and Update Listings in LP

The LP API functions similarly to the Reverb core API, so please refer to the Getting Started docs if you're just getting started with the integration.

Note that for sandbox testing, listings will go to sandbox.reverb.com but querying LP data will come from LP production, lp.reverb.com.

For any questions, please email integrations@reverb.com.

Create an LP Listing

To create an LP listing, submit a request like this:

curl -XPOST -H "Accept-Version: 3.0" -H "Authorization: Bearer [token]" -H "Content-Type: application/hal+json" https://reverb.com/api/listings --data '

{
    "categories": [
        {
            "uuid": "b891b5df-051c-4ee1-ac91-c9a38f62ef90"
        },
        {
            "uuid": "811382af-d7f8-4529-9c46-a8aa8d99403e"
        }
    ],
    "cloudinary_photos": [],
    "description": "Sample description.",
    "merchandising_uuid": "236094db-dcc6-403e-964b-17030adf7d4c",
    "offers_enabled": true,
    "price": {
        "amount": "23",
        "currency": "USD"
    },
    "publish": true,
    "seller_cost": "10.99",
    "sku": "abc-123b",
    "storage_location": "closet",
    "title": "Death Cab For Cutie - We Have The Facts And We're Voting Yes - Vinyl",
    "trait_value_uuids": [
        "aac035ae-68bd-4f38-93ea-0cfaab1ffec9",
        "38d7284f-09bb-4d49-8dc0-6f9fb4469fea"
    ],
    "trait_values": {
        "44340fd2-bca0-4a11-9145-54f70082e847": 1
    }
}
'

Trait Breakdowns

These will be updated once the API endpoints have been configured for Reverb LP. The endpoint that will be changed is api/listing_conditions.

categories
b891b5df-051c-4ee1-ac91-c9a38f62ef90 - represents recorded music and should be included for all

lp listings
811382af-d7f8-4529-9c46-a8aa8d99403e - represents the format (lp for this instance).

merchandising_uuid
relates to lp's unique identifier for the release

title
is written as the {artist} - {album} - {format} for ease of reference on orders

trait_value_uuids
should have two of these, one representing the sleeve condition and the other the media condition, here's a reference of acceptable values

trait_values
this is a third trait that should be sent with an integer value representing the format quantity, e.g. 2 for a double lp, for reference:

Sleeve Conditions

Not Graded

eb767f2f-cafc-4215-a823-8fe0329c0310

Generic

eb767f2f-cafc-4215-a823-8fe0329c0310

No Cover

0c6a3224-bd9c-40da-a2a1-e640a0631aa4

Mint (M)

6e70b061-c753-44d5-9968-e717266685da

Near Mint (NM or M-)

4613cedd-0a63-4b08-a1ea-6cce4fcdc069

Very Good Plus (VG+)

b965e14a-ece9-4287-9e27-d282af7326e4

Very Good (VG)

b0d3ffd0-81e1-4f45-a91a-a449c05bd6da

Good Plus (G+)

aac035ae-68bd-4f38-93ea-0cfaab1ffec9

Good (G)

1b1739f8-0d17-4692-8a8f-8e23fe2cb57c

Fair (F)

cf94f5a0-9b48-4f66-afc4-438ec3ed8e4e

Poor (P)

489bdbe7-9f5f-4075-859b-3da0bb9f4bf3

Media Conditions

Mint (M)

2981e0e5-5770-48d8-89ab-ed4b378da220

Near Mint (NM or M-)

7e6bbb82-419f-48d3-b7cd-d196cfa8ed34

Very Good Plus (VG+)

38d7284f-09bb-4d49-8dc0-6f9fb4469fea

Very Good (VG)

8eec19fb-01cc-466e-b1d5-c7405f8e9538

Good Plus (G+)

8945e258-e249-4c98-86d9-305f5b2098ca

Good (G)

06230b7a-3f8b-40a4-978b-dcdc87598fcb

Fair (F)

896c4b33-03ea-44b4-990e-7f023d97d519

Poor (P)

e25cdf2b-3595-4631-817f-7fc0bdac8bf4

To update a listing

To update an LP listing, submit a request like this:

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

Shipping Profiles and Shipping Rates

An importance difference for Reverb LP is that we rely on a shipping profile that uses a standard and incremental rate, the incremental being used when people order additional items for the same shop at the same time. Thus, be sure to set up a Reverb LP Shipping Profile within Reverb LP before syncing.

Inventory

There are two flags that must be set:

  • has_inventory = true
  • inventory = [n]

For most cases, we should be using has_inventory=true for sellers who are selling retail items that have inventory. If you are selling a unique item, you can set has_inventory=false and the inventory field will be ignored. If you specify inventory=0 for any item, regardless of whether it supports inventory, this will end the listing.