openapi-directory/api/reverb.com.json

Building & bundling https://github.com/APIs-guru/openapi-directory for easy use from JS

{"openapi":"3.0.0","x-hasEquivalentPaths":true,"info":{"contact":{"email":"integrations@reverb.com","name":"Reverb API","url":"https://www.reverb-api.com"},"description":"reverb","license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"},"termsOfService":"https://reverb.com/page/terms","title":"reverb","version":"3.0","x-apisguru-categories":["ecommerce"],"x-logo":{"url":"https://d1g5417jjjo7sf.cloudfront.net/assets/top-level/reverb-logo-d2c75af0b020521f0bc5e90c883a13b5.svg"},"x-origin":[{"format":"swagger","url":"https://s3.amazonaws.com/swagger.reverb.com/swagger.json","version":"2.0"}],"x-providerName":"reverb.com"},"externalDocs":{"url":"https://dev.reverb.com/"},"paths":{"/articles":{"get":{"parameters":[{"in":"query","name":"page","required":false,"schema":{"type":"integer","default":1}},{"in":"query","name":"per_page","required":false,"schema":{"type":"integer","default":24}},{"in":"query","name":"offset","required":false,"schema":{"type":"integer"}},{"description":"What's being searched for","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Number of featured articles to exclude","in":"query","name":"exclude_featured","required":false,"schema":{"type":"integer"}}],"responses":{"default":{"description":"Unexpected error"}},"tags":["articles"]}},"/articles/categories":{"get":{"description":"List of all article categories","responses":{"default":{"description":"Unexpected error"}},"summary":"List of all article categories","tags":["articles"]}},"/categories":{"get":{"description":"List of supported product categories","responses":{"default":{"description":"Unexpected error"}},"summary":"List of supported product categories","tags":["categories"]}},"/categories/flat":{"get":{"responses":{"default":{"description":"Unexpected error"}},"tags":["categories"]}},"/categories/taxonomy":{"get":{"description":"Full taxonomy tree of categories including middle categories","responses":{"default":{"description":"Unexpected error"}},"summary":"Full taxonomy tree of categories including middle categories","tags":["categories"]}},"/categories/{product_type}/{category}":{"get":{"description":"Get subcategory details","parameters":[{"in":"path","name":"product_type","required":true,"schema":{"type":"string"}},{"in":"path","name":"category","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"Get subcategory details","tags":["categories"]}},"/categories/{uuid}":{"get":{"description":"Get category details","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"Get category details","tags":["categories"]}},"/comparison_shopping_pages":{"get":{"description":"Returns a set of comparison shopping pages based on the current params","responses":{"default":{"description":"Unexpected error"}},"summary":"Returns a set of comparison shopping pages based on the current params","tags":["comparison_shopping_pages"]}},"/comparison_shopping_pages/find":{"get":{"description":"Show comparison shopping page","parameters":[{"description":"ID of the comparison shopping page","in":"query","name":"id","required":false,"schema":{"type":"string"}},{"description":"Slug of the comparison shopping page","in":"query","name":"slug","required":false,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"Show comparison shopping page","tags":["comparison_shopping_pages"]}},"/comparison_shopping_pages/{id}":{"get":{"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"tags":["comparison_shopping_pages"]}},"/comparison_shopping_pages/{id}/listings":{"get":{"description":"Return new or used listings for a comparison shopping page","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Condition of the listing","in":"query","name":"condition","required":true,"schema":{"type":"string"}},{"in":"query","name":"page","required":false,"schema":{"type":"integer","default":1}},{"in":"query","name":"per_page","required":false,"schema":{"type":"integer","default":24}},{"in":"query","name":"offset","required":false,"schema":{"type":"integer"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"Return new or used listings for a comparison shopping page","tags":["comparison_shopping_pages"]}},"/comparison_shopping_pages/{id}/reviews":{"get":{"description":"View reviews of a comparison shopping page","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"View reviews of a comparison shopping page","tags":["comparison_shopping_pages"]}},"/conversations/{conversation_id}/offer":{"post":{"description":"Make an offer to the other participant in the conversation","parameters":[{"in":"path","name":"conversation_id","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/Body3"},"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_offers"]}],"summary":"Make an offer to the other participant in the conversation","tags":["conversations"]}},"/conversations/{id}/offer":{"post":{"description":"Make an offer to the other participant in the conversation","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/Body4"},"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_offers"]}],"summary":"Make an offer to the other participant in the conversation","tags":["conversations"]}},"/countries":{"get":{"description":"Retrieve a list of country codes with corresponding subregions","responses":{"default":{"description":"Unexpected error"}},"summary":"Retrieve a list of country codes with corresponding subregions","tags":["countries"]}},"/csps":{"get":{"description":"Returns a set of comparison shopping pages based on the current params","responses":{"default":{"description":"Unexpected error"}},"summary":"Returns a set of comparison shopping pages based on the current params","tags":["csps"]}},"/csps/categories":{"get":{"responses":{"default":{"description":"Unexpected error"}},"tags":["csps"]}},"/curated_sets/{slug}":{"get":{"parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"tags":["curated_sets"]}},"/currencies/display":{"get":{"description":"List of supported display currencies for browsing listings","responses":{"default":{"description":"Unexpected error"}},"summary":"List of supported display currencies for browsing listings","tags":["currencies"]}},"/currencies/listing":{"get":{"description":"List of supported listing currencies for shops","responses":{"default":{"description":"Unexpected error"}},"summary":"List of supported listing currencies for shops","tags":["currencies"]}},"/feedback/{feedback_id}":{"get":{"description":"Feedback details","parameters":[{"in":"path","name":"feedback_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"Feedback details","tags":["feedback"]}},"/handpicked/{slug}":{"get":{"description":"Get results from a handpicked collection","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}},{"description":"Search query.","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Maximum current auction price","in":"query","name":"auction_price_max","required":false,"schema":{"type":"number","format":"float"}},{"description":"Category slug from /api/categories","in":"query","name":"category","required":false,"schema":{"type":"string"}},{"description":"Product type slug from /api/categories","in":"query","name":"product_type","required":false,"schema":{"type":"string"}},{"description":"Condition: all,new,b-stock,used,non-functioning","in":"query","name":"conditions","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Decade: e.g. 1970s, early 70s","in":"query","name":"decade","required":false,"schema":{"type":"string"}},{"description":"Visual finish of the item, common for guitars","in":"query","name":"finish","required":false,"schema":{"type":"string"}},{"description":"Handmade items only","in":"query","name":"handmade","required":false,"schema":{"type":"boolean"}},{"description":"City where item is located","in":"query","name":"item_city","required":false,"schema":{"type":"string"}},{"description":"DEPRECATED - Country code where item is located","in":"query","name":"item_country","required":false,"schema":{"type":"string"}},{"description":"Country code where item is located","in":"query","name":"item_region","required":false,"schema":{"type":"string"}},{"description":"State or region code where item is located","in":"query","name":"item_state","required":false,"schema":{"type":"string"}},{"description":"Make(s)/brand of item (e.g. Fender). Can take a single value or an array.","in":"query","name":"make","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Model of item (e.g. Stratocaster)","in":"query","name":"model","required":false,"schema":{"type":"string"}},{"description":"Search term negation. If you want to exclude a term, add it here","in":"query","name":"must_not","required":false,"schema":{"type":"string"}},{"description":"Maximum price of search results (USD)","in":"query","name":"price_max","required":false,"schema":{"type":"number","format":"float"}},{"description":"Minimum price of search results (USD)","in":"query","name":"price_min","required":false,"schema":{"type":"number","format":"float"}},{"description":"The currency to be used for the price filters","in":"query","name":"currency","required":false,"schema":{"type":"string"}},{"description":"Maximum year of manufacture","in":"query","name":"year_max","required":false,"schema":{"type":"integer"}},{"description":"Minumum year of manufacture","in":"query","name":"year_min","required":false,"schema":{"type":"integer"}},{"description":"If true, include only items that accept gift cards","in":"query","name":"accepts_gift_cards","required":false,"schema":{"type":"boolean"}},{"description":"If true, include only items by Reverb Preferred Sellers","in":"query","name":"preferred_seller","required":false,"schema":{"type":"boolean"}},{"description":"Slug of shop to search","in":"query","name":"shop","required":false,"schema":{"type":"string"}},{"description":"ID of shop to search","in":"query","name":"shop_id","required":false,"schema":{"type":"string"}},{"description":"Type of listing: auctions,offers","in":"query","name":"listing_type","required":false,"schema":{"type":"string"}},{"description":"Limit search to items that ship to this country code","in":"query","name":"ships_to","required":false,"schema":{"type":"string"}},{"description":"If true, exclude auctions","in":"query","name":"exclude_auctions","required":false,"schema":{"type":"boolean"}},{"description":"If true, only show items that can be purchased with a payment plan","in":"query","name":"accepts_payment_plans","required":false,"schema":{"type":"boolean"}},{"description":"Minimum number of watchers (used to find popular items)","in":"query","name":"watchers_count_min","required":false,"schema":{"type":"integer"}},{"description":"Listing ID negation. If you want to exclude a listing, add it here.","in":"query","name":"not_ids","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"in":"query","name":"page","required":false,"schema":{"type":"integer","default":1}},{"in":"query","name":"per_page","required":false,"schema":{"type":"integer","default":24}},{"in":"query","name":"offset","required":false,"schema":{"type":"integer"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"Get results from a handpicked collection","tags":["handpicked"]}},"/listing_conditions":{"get":{"description":"List of supported product conditions","responses":{"default":{"description":"Unexpected error"}},"summary":"List of supported product conditions","tags":["listing_conditions"]}},"/listings":{"get":{"description":"Default search of listings includes only used & handmade. Add a filter to view all listings or use the /listings/all endpoint.","parameters":[{"description":"Search query.","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Maximum current auction price","in":"query","name":"auction_price_max","required":false,"schema":{"type":"number","format":"float"}},{"description":"Category slug from /api/categories","in":"query","name":"category","required":false,"schema":{"type":"string"}},{"description":"Product type slug from /api/categories","in":"query","name":"product_type","required":false,"schema":{"type":"string"}},{"description":"Condition: all,new,b-stock,used,non-functioning","in":"query","name":"conditions","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Decade: e.g. 1970s, early 70s","in":"query","name":"decade","required":false,"schema":{"type":"string"}},{"description":"Visual finish of the item, common for guitars","in":"query","name":"finish","required":false,"schema":{"type":"string"}},{"description":"Handmade items only","in":"query","name":"handmade","required":false,"schema":{"type":"boolean"}},{"description":"City where item is located","in":"query","name":"item_city","required":false,"schema":{"type":"string"}},{"description":"DEPRECATED - Country code where item is located","in":"query","name":"item_country","required":false,"schema":{"type":"string"}},{"description":"Country code where item is located","in":"query","name":"item_region","required":false,"schema":{"type":"string"}},{"description":"State or region code where item is located","in":"query","name":"item_state","required":false,"schema":{"type":"string"}},{"description":"Make(s)/brand of item (e.g. Fender). Can take a single value or an array.","in":"query","name":"make","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Model of item (e.g. Stratocaster)","in":"query","name":"model","required":false,"schema":{"type":"string"}},{"description":"Search term negation. If you want to exclude a term, add it here","in":"query","name":"must_not","required":false,"schema":{"type":"string"}},{"description":"Maximum price of search results (USD)","in":"query","name":"price_max","required":false,"schema":{"type":"number","format":"float"}},{"description":"Minimum price of search results (USD)","in":"query","name":"price_min","required":false,"schema":{"type":"number","format":"float"}},{"description":"The currency to be used for the price filters","in":"query","name":"currency","required":false,"schema":{"type":"string"}},{"description":"Maximum year of manufacture","in":"query","name":"year_max","required":false,"schema":{"type":"integer"}},{"description":"Minumum year of manufacture","in":"query","name":"year_min","required":false,"schema":{"type":"integer"}},{"description":"If true, include only items that accept gift cards","in":"query","name":"accepts_gift_cards","required":false,"schema":{"type":"boolean"}},{"description":"If true, include only items by Reverb Preferred Sellers","in":"query","name":"preferred_seller","required":false,"schema":{"type":"boolean"}},{"description":"Slug of shop to search","in":"query","name":"shop","required":false,"schema":{"type":"string"}},{"description":"ID of shop to search","in":"query","name":"shop_id","required":false,"schema":{"type":"string"}},{"description":"Type of listing: auctions,offers","in":"query","name":"listing_type","required":false,"schema":{"type":"string"}},{"description":"Limit search to items that ship to this country code","in":"query","name":"ships_to","required":false,"schema":{"type":"string"}},{"description":"If true, exclude auctions","in":"query","name":"exclude_auctions","required":false,"schema":{"type":"boolean"}},{"description":"If true, only show items that can be purchased with a payment plan","in":"query","name":"accepts_payment_plans","required":false,"schema":{"type":"boolean"}},{"description":"Minimum number of watchers (used to find popular items)","in":"query","name":"watchers_count_min","required":false,"schema":{"type":"integer"}},{"description":"Listing ID negation. If you want to exclude a listing, add it here.","in":"query","name":"not_ids","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"in":"query","name":"page","required":false,"schema":{"type":"integer","default":1}},{"in":"query","name":"per_page","required":false,"schema":{"type":"integer","default":24}},{"in":"query","name":"offset","required":false,"schema":{"type":"integer"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"Default search of listings includes only used & handmade. Add a filter to view all listings or use the /listings/all endpoint.","tags":["listings"]},"post":{"description":"Create a listing","requestBody":{"$ref":"#/components/requestBodies/Body"},"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_listings","write_listings_for_others"]}],"summary":"Create a listing","tags":["listings"]}},"/listings/all":{"get":{"description":"All listings including used, handmade, and brand new","parameters":[{"description":"Search query.","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Maximum current auction price","in":"query","name":"auction_price_max","required":false,"schema":{"type":"number","format":"float"}},{"description":"Category slug from /api/categories","in":"query","name":"category","required":false,"schema":{"type":"string"}},{"description":"Product type slug from /api/categories","in":"query","name":"product_type","required":false,"schema":{"type":"string"}},{"description":"Condition: all,new,b-stock,used,non-functioning","in":"query","name":"conditions","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Decade: e.g. 1970s, early 70s","in":"query","name":"decade","required":false,"schema":{"type":"string"}},{"description":"Visual finish of the item, common for guitars","in":"query","name":"finish","required":false,"schema":{"type":"string"}},{"description":"Handmade items only","in":"query","name":"handmade","required":false,"schema":{"type":"boolean"}},{"description":"City where item is located","in":"query","name":"item_city","required":false,"schema":{"type":"string"}},{"description":"DEPRECATED - Country code where item is located","in":"query","name":"item_country","required":false,"schema":{"type":"string"}},{"description":"Country code where item is located","in":"query","name":"item_region","required":false,"schema":{"type":"string"}},{"description":"State or region code where item is located","in":"query","name":"item_state","required":false,"schema":{"type":"string"}},{"description":"Make(s)/brand of item (e.g. Fender). Can take a single value or an array.","in":"query","name":"make","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Model of item (e.g. Stratocaster)","in":"query","name":"model","required":false,"schema":{"type":"string"}},{"description":"Search term negation. If you want to exclude a term, add it here","in":"query","name":"must_not","required":false,"schema":{"type":"string"}},{"description":"Maximum price of search results (USD)","in":"query","name":"price_max","required":false,"schema":{"type":"number","format":"float"}},{"description":"Minimum price of search results (USD)","in":"query","name":"price_min","required":false,"schema":{"type":"number","format":"float"}},{"description":"The currency to be used for the price filters","in":"query","name":"currency","required":false,"schema":{"type":"string"}},{"description":"Maximum year of manufacture","in":"query","name":"year_max","required":false,"schema":{"type":"integer"}},{"description":"Minumum year of manufacture","in":"query","name":"year_min","required":false,"schema":{"type":"integer"}},{"description":"If true, include only items that accept gift cards","in":"query","name":"accepts_gift_cards","required":false,"schema":{"type":"boolean"}},{"description":"If true, include only items by Reverb Preferred Sellers","in":"query","name":"preferred_seller","required":false,"schema":{"type":"boolean"}},{"description":"Slug of shop to search","in":"query","name":"shop","required":false,"schema":{"type":"string"}},{"description":"ID of shop to search","in":"query","name":"shop_id","required":false,"schema":{"type":"string"}},{"description":"Type of listing: auctions,offers","in":"query","name":"listing_type","required":false,"schema":{"type":"string"}},{"description":"Limit search to items that ship to this country code","in":"query","name":"ships_to","required":false,"schema":{"type":"string"}},{"description":"If true, exclude auctions","in":"query","name":"exclude_auctions","required":false,"schema":{"type":"boolean"}},{"description":"If true, only show items that can be purchased with a payment plan","in":"query","name":"accepts_payment_plans","required":false,"schema":{"type":"boolean"}},{"description":"Minimum number of watchers (used to find popular items)","in":"query","name":"watchers_count_min","required":false,"schema":{"type":"integer"}},{"description":"Listing ID negation. If you want to exclude a listing, add it here.","in":"query","name":"not_ids","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"in":"query","name":"page","required":false,"schema":{"type":"integer","default":1}},{"in":"query","name":"per_page","required":false,"schema":{"type":"integer","default":24}},{"in":"query","name":"offset","required":false,"schema":{"type":"integer"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"All listings including used, handmade, and brand new","tags":["listings"]}},"/listings/facets/seller_location":{"get":{"description":"Individual facets","responses":{"default":{"description":"Unexpected error"}},"summary":"Individual facets","tags":["listings"]}},"/listings/{id}/negotiation":{"get":{"description":"Returns the latest negotiation for the requesting user given a listing id","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_offers"]}],"summary":"Returns the latest negotiation for the requesting user given a listing id","tags":["listings"]}},"/listings/{id}/offer":{"post":{"description":"Make an offer to the seller of a listing","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/Body4"},"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_offers"]}],"summary":"Make an offer to the seller of a listing","tags":["listings"]}},"/listings/{listing_id}/bump":{"get":{"description":"View available bump tiers and stats for a listing","parameters":[{"in":"path","name":"listing_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_listings"]}],"summary":"View available bump tiers and stats for a listing","tags":["listings"]}},"/listings/{listing_id}/bump/{budget_type}":{"post":{"description":"Bump a listing","parameters":[{"in":"path","name":"listing_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"budget_type","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_listings"]}],"summary":"Bump a listing","tags":["listings"]}},"/listings/{listing_id}/conversations":{"post":{"description":"Start a conversation with a seller","parameters":[{"in":"path","name":"listing_id","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/Body2"},"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_messages"]}],"summary":"Start a conversation with a seller","tags":["listings"]}},"/listings/{listing_id}/images":{"get":{"description":"View the images associated with a particular listing","parameters":[{"in":"path","name":"listing_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_listings"]}],"summary":"View the images associated with a particular listing","tags":["listings"]}},"/listings/{listing_id}/images/{image_id}":{"delete":{"description":"Delete an image from a listing","parameters":[{"in":"path","name":"listing_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"image_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_listings"]}],"summary":"Delete an image from a listing","tags":["listings"]}},"/listings/{listing_id}/product_bundle":{"get":{"description":"Find a product bundle attached to a listing","parameters":[{"in":"path","name":"listing_id","required":true,"schema":{"type":"string"}},{"description":"Pass to see non-live bundles as the seller","in":"query","name":"for_seller","required":false,"schema":{"type":"boolean"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"Find a product bundle attached to a listing","tags":["listings"]}},"/listings/{listing_id}/sales":{"get":{"description":"See all sales that include a listing.","parameters":[{"in":"path","name":"listing_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"See all sales that include a listing.","tags":["listings"]}},"/listings/{slug}":{"delete":{"description":"Delete a draft listing. Cannot be used on non-drafts.","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_listings"]}],"summary":"Delete a draft listing. Cannot be used on non-drafts.","tags":["listings"]},"get":{"description":"Listing details","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"Listing details","tags":["listings"]},"put":{"description":"Update a listing","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/Body"},"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_listings"]}],"summary":"Update a listing","tags":["listings"]}},"/listings/{slug}/edit":{"get":{"description":"Edit listing.","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_listings"]}],"summary":"Edit listing.","tags":["listings"]}},"/listings/{slug}/flag":{"post":{"description":"Flag a listing for inappropriate content or fraud","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"reason":{"description":"Valid reasons: 'Sexuality/nudity', 'Hateful or inappropriate speech', 'Item not as described or potential fraud', 'Trademark infringement', 'Other'","type":"string"}},"required":["reason"],"type":"object"}}},"description":"the content of the request"},"responses":{"default":{"description":"Unexpected error"}},"summary":"Flag a listing for inappropriate content or fraud","tags":["listings"]}},"/listings/{slug}/reviews":{"get":{"description":"View reviews of a listing","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"View reviews of a listing","tags":["listings"]},"post":{"description":"Create a review for a listing","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_reviews"]}],"summary":"Create a review for a listing","tags":["listings"]}},"/listings/{slug}/similar_listings":{"get":{"description":"Listing details","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"summary":"Listing details","tags":["listings"]}},"/my/account":{"get":{"description":"Get account details","responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_profile"]}],"summary":"Get account details","tags":["my"]},"put":{"description":"Update account details","requestBody":{"content":{"application/json":{"schema":{"properties":{"currency":{"description":"The currency preference for the account","type":"string"},"first_name":{"description":"The first name of the account holder","type":"string"},"last_name":{"description":"The last name of the account holder","type":"string"},"locale_code":{"description":"The locale code for the account","type":"string"},"shipping_region_code":{"description":"The shipping region preference for the account","type":"string"}},"type":"object"}}},"description":"the content of the request"},"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_profile"]}],"summary":"Update account details","tags":["my"]}},"/my/addresses":{"get":{"description":"See all addresses in your address book","responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_profile"]}],"summary":"See all addresses in your address book","tags":["my"]},"post":{"description":"Create a new address in your address book","responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_profile"]}],"summary":"Create a new address in your address book","tags":["my"]}},"/my/addresses/{address_id}":{"delete":{"description":"Delete an existing address in your address book","parameters":[{"in":"path","name":"address_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_profile"]}],"summary":"Delete an existing address in your address book","tags":["my"]},"put":{"description":"Update an existing address in your address book","parameters":[{"in":"path","name":"address_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_profile"]}],"summary":"Update an existing address in your address book","tags":["my"]}},"/my/conversations":{"get":{"description":"Get a list of your conversations","parameters":[{"description":"Query string to search conversations by","in":"query","name":"search","required":false,"schema":{"type":"string"}},{"description":"Show unread conversations only","in":"query","name":"unread_only","required":false,"schema":{"type":"boolean"}},{"in":"query","name":"page","required":false,"schema":{"type":"integer","default":1}},{"in":"query","name":"per_page","required":false,"schema":{"type":"integer","default":24}},{"in":"query","name":"offset","required":false,"schema":{"type":"integer"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_messages"]}],"summary":"Get a list of your conversations","tags":["my"]},"post":{"description":"Start a conversation","requestBody":{"content":{"application/json":{"schema":{"properties":{"body":{"description":"The body of the message","type":"string"},"cloudinary_photos":{"description":"An array of cloudinary data hashes (Reverb internal use only).","items":{"type":"string"},"type":"array"},"listing_id":{"description":"The id of the listing being discussed","type":"integer"},"recipient_id":{"description":"The id of the user you are trying to contact","type":"integer"},"recipient_uuid":{"description":"The uuid of the user you are trying to contact","type":"string"},"shop_id":{"description":"The id of the shop you are trying to contact","type":"string"}},"required":["body"],"type":"object"}}},"description":"the content of the request"},"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_messages"]}],"summary":"Start a conversation","tags":["my"]}},"/my/conversations/{conversation_id}/messages":{"post":{"description":"Send a message","parameters":[{"in":"path","name":"conversation_id","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/Body2"},"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_messages"]}],"summary":"Send a message","tags":["my"]}},"/my/conversations/{id}":{"get":{"description":"Display conversation details with messages in natural time order (oldest to newest)","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_messages"]}],"summary":"Display conversation details with messages in natural time order (oldest to newest)","tags":["my"]},"put":{"description":"Mark a conversation read/unread","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"read":{"description":"Should the conversation be marked as read","type":"boolean"}},"type":"object"}}},"description":"the content of the request"},"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_messages"]}],"summary":"Mark a conversation read/unread","tags":["my"]}},"/my/counts":{"get":{"description":"Get your actionable status counts","responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_profile"]}],"summary":"Get your actionable status counts","tags":["my"]}},"/my/curated_set/product/{product_id}":{"delete":{"parameters":[{"in":"path","name":"product_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"tags":["my"]},"post":{"parameters":[{"in":"path","name":"product_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"tags":["my"]}},"/my/feed":{"get":{"description":"Get listings from your feed","responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_lists"]}],"summary":"Get listings from your feed","tags":["my"]}},"/my/feed/customize":{"get":{"description":"get your feed customization options","responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_lists"]}],"summary":"get your feed customization options","tags":["my"]}},"/my/feed/grid":{"get":{"description":"get your feed","responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_lists"]}],"summary":"get your feed","tags":["my"]}},"/my/feedback/received":{"get":{"description":"List of received feedback","responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_feedback"]}],"summary":"List of received feedback","tags":["my"]}},"/my/feedback/sent":{"get":{"description":"List of sent feedback","responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_feedback"]}],"summary":"List of sent feedback","tags":["my"]}},"/my/follows":{"get":{"description":"See what the user is following","responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_lists"]}],"summary":"See what the user is following","tags":["my"]}},"/my/follows/articles":{"get":{"description":"Returns a user's ArticleCategoryFollows","responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_lists"]}],"summary":"Returns a user's ArticleCategoryFollows","tags":["my"]},"post":{"description":"Set a user's ArticleCategoryFollows","requestBody":{"content":{"application/json":{"schema":{"properties":{"category_uuids":{"type":"string"}},"required":["category_uuids"],"type":"object"}}},"description":"the content of the request"},"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Set a user's ArticleCategoryFollows","tags":["my"]}},"/my/follows/brands/{slug}":{"delete":{"description":"Unfollow a brand","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Unfollow a brand","tags":["my"]},"get":{"description":"Follow status for a brand","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_lists"]}],"summary":"Follow status for a brand","tags":["my"]},"post":{"description":"Follow a brand","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Follow a brand","tags":["my"]}},"/my/follows/categories/{category}/{subcategory}":{"delete":{"description":"Unfollow a subcategory","parameters":[{"in":"path","name":"category","required":true,"schema":{"type":"string"}},{"in":"path","name":"subcategory","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Unfollow a subcategory","tags":["my"]},"get":{"description":"Follow status for a subcategory","parameters":[{"in":"path","name":"category","required":true,"schema":{"type":"string"}},{"in":"path","name":"subcategory","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_lists"]}],"summary":"Follow status for a subcategory","tags":["my"]},"post":{"description":"Follow a subcategory","parameters":[{"in":"path","name":"category","required":true,"schema":{"type":"string"}},{"in":"path","name":"subcategory","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Follow a subcategory","tags":["my"]}},"/my/follows/categories/{identifier}":{"delete":{"description":"Unfollow a category","parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Unfollow a category","tags":["my"]},"get":{"description":"Follow status for a category","parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_lists"]}],"summary":"Follow status for a category","tags":["my"]},"post":{"description":"Follow a category","parameters":[{"in":"path","name":"identifier","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Follow a category","tags":["my"]}},"/my/follows/categories/{uuid}":{"post":{"description":"Follow a category","parameters":[{"in":"path","name":"uuid","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Follow a category","tags":["my"]}},"/my/follows/collections/{slug}":{"delete":{"description":"Unfollow a collection","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Unfollow a collection","tags":["my"]},"get":{"description":"Follow status for a collection","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_lists"]}],"summary":"Follow status for a collection","tags":["my"]},"post":{"description":"Follow a collection","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Follow a collection","tags":["my"]}},"/my/follows/handpicked/{slug}":{"delete":{"description":"Unfollow a handpicked collection","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Unfollow a handpicked collection","tags":["my"]},"get":{"description":"Follow status for a handpicked collection","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_lists"]}],"summary":"Follow status for a handpicked collection","tags":["my"]},"post":{"description":"Follow a handpicked collection","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Follow a handpicked collection","tags":["my"]}},"/my/follows/search":{"get":{"description":"Follow status for a search","responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_lists"]}],"summary":"Follow status for a search","tags":["my"]},"post":{"description":"Follow a search","requestBody":{"content":{"application/json":{"schema":{"properties":{"accepts_gift_cards":{"description":"If true, include only items that accept gift cards","type":"boolean"},"accepts_payment_plans":{"description":"If true, only show items that can be purchased with a payment plan","type":"boolean"},"auction_price_max":{"description":"Maximum current auction price","format":"float","type":"number"},"category":{"description":"Category slug from /api/categories","type":"string"},"conditions":{"description":"Condition: all,new,b-stock,used,non-functioning","enum":["all","new","b-stock","used","non-functioning"],"items":{"type":"string"},"type":"array"},"currency":{"description":"The currency to be used for the price filters","enum":["USD","CAD","EUR","GBP","AUD","JPY","NZD","MXN"],"type":"string"},"decade":{"description":"Decade: e.g. 1970s, early 70s","type":"string"},"exclude_auctions":{"description":"If true, exclude auctions","type":"boolean"},"finish":{"description":"Visual finish of the item, common for guitars","type":"string"},"handmade":{"description":"Handmade items only","type":"boolean"},"item_city":{"description":"City where item is located","type":"string"},"item_country":{"description":"DEPRECATED - Country code where item is located","type":"string"},"item_region":{"description":"Country code where item is located","type":"string"},"item_state":{"description":"State or region code where item is located","type":"string"},"listing_type":{"description":"Type of listing: auctions,offers","enum":["auctions","offers"],"type":"string"},"make":{"description":"Make(s)/brand of item (e.g. Fender). Can take a single value or an array.","items":{"type":"string"},"type":"array"},"model":{"description":"Model of item (e.g. Stratocaster)","type":"string"},"must_not":{"description":"Search term negation. If you want to exclude a term, add it here","type":"string"},"not_ids":{"description":"Listing ID negation. If you want to exclude a listing, add it here.","items":{"type":"integer"},"type":"array"},"preferred_seller":{"description":"If true, include only items by Reverb Preferred Sellers","type":"boolean"},"price_max":{"description":"Maximum price of search results (USD)","format":"float","type":"number"},"price_min":{"description":"Minimum price of search results (USD)","format":"float","type":"number"},"product_type":{"description":"Product type slug from /api/categories","type":"string"},"query":{"description":"Search query.","type":"string"},"ships_to":{"description":"Limit search to items that ship to this country code","type":"string"},"shop":{"description":"Slug of shop to search","type":"string"},"shop_id":{"description":"ID of shop to search","type":"string"},"watchers_count_min":{"description":"Minimum number of watchers (used to find popular items)","type":"integer"},"year_max":{"description":"Maximum year of manufacture","type":"integer"},"year_min":{"description":"Minumum year of manufacture","type":"integer"}},"type":"object"}}},"description":"the content of the request"},"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Follow a search","tags":["my"]}},"/my/follows/shops/{slug}":{"delete":{"description":"Unfollow a shop","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Unfollow a shop","tags":["my"]},"get":{"description":"Follow status for a shop","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["read_lists"]}],"summary":"Follow status for a shop","tags":["my"]},"post":{"description":"Follow a shop","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Follow a shop","tags":["my"]}},"/my/follows/{follow_id}":{"delete":{"description":"Delete a follow","parameters":[{"in":"path","name":"follow_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"security":[{"oauth2":["write_lists"]}],"summary":"Delete a follow","tags":["my"]}},"/my/follows/{follow_id}/alert":{"delete":{"parameters":[{"in":"path","name":"follow_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"tags":["my"]},"post":{"parameters":[{"in":"path","name":"follow_id","required":true,"schema":{"type":"string"}}],"responses":{"default":{"description":"Unexpected error"}},"tags":["my"]}},"/my/listings":{"get":{"description":"Retrieve a list of live listings for the seller. To search all listings specify state=all","parameters":[{"description":"Search query.","in":"query","name":"query","required":false,"schema":{"type":"string"}},{"description":"Maximum current auction price","in":"query","name":"auction_price_max","required":false,"schema":{"type":"number","format":"float"}},{"description":"Category slug from /api/categories","in":"query","name":"category","required":false,"schema":{"type":"string"}},{"description":"Product type slug from /api/categories","in":"query","name":"product_type","required":false,"schema":{"type":"string"}},{"description":"Condition: all,new,b-stock,used,non-functioning","in":"query","name":"conditions","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Decade: e.g. 1970s, early 70s","in":"query","name":"decade","required":false,"schema":{"type":"string"}},{"description":"Visual finish of the item, common for guitars","in":"query","name":"finish","required":false,"schema":{"type":"string"}},{"description":"Handmade items only","in":"query","name":"handmade","required":false,"schema":{"type":"boolean"}},{"description":"City where item is located","in":"query","name":"item_city","required":false,"schema":{"type":"string"}},{"description":"DEPRECATED - Country code where item is located","in":"query","name":"item_country","required":false,"schema":{"type":"string"}},{"description":"Country code where item is located","in":"query","name":"item_region","required":false,"schema":{"type":"string"}},{"description":"State or region code where item is located","in":"query","name":"item_state","required":false,"schema":{"type":"string"}},{"description":"Make(s)/brand of item (e.g. Fender). Can take a single value or an array.","in":"query","name":"make","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"description":"Model of item (e.g. Stratocaster)","in":"query","name":"model","required":false,"schema":{"type":"string"}},{"description":"Search term negation. If you want to exclude a term, add it here","in":"query","name":"must_not","required":false,"schema":{"type":"string"}},{"description":"Maximum price of search results (USD)","in":"query","name":"price_max","required":false,"schema":{"type":"number","format":"float"}},{"description":"Minimum price of search results (USD)","in":"query","name":"price_min","required":false,"schema":{"type":"number","format":"float"}},{"description":"The currency to be used for the price filters","in":"query","name":"currency","required":false,"schema":{"type":"string"}},{"description":"Maximum year of manufacture","in":"query","name":"year_max","required":false,"schema":{"type":"integer"}},{"description":"Minumum year of manufacture","in":"query","name":"year_min","required":false,"schema":{"type":"integer"}},{"description":"If true, include only items that accept gift cards","in":"query","name":"accepts_gift_cards","required":false,"schema":{"type":"boolean"}},{"description":"If true, include only items by Reverb Preferred Sellers","in":"query","name":"preferred_seller","required":false,"schema":{"type":"boolean"}},{"description":"Slug of shop to search","in":"query","name":"shop","required":false,"schema":{"type":"