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 [email protected]

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

Media Conditions

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.