OpenAPI Specification
openapi: 3.1.0
info:
title: Reverb Accounts My API
version: 1.0.0
description: 'Reverb is a marketplace for new, used, and vintage musical instruments and gear
(owned by Etsy). The Reverb API is a HATEOAS hypermedia REST API that responds
with application/hal+json. Clients should generally follow links in the
`_links` element of responses rather than hard-coding URL structures. This
specification documents the publicly discoverable root resources advertised at
https://reverb.com/api together with the authentication token endpoint.
'
contact:
name: Reverb API
url: https://reverb.com/page/api
license:
name: Proprietary
servers:
- url: https://reverb.com
description: Reverb production API host
security:
- XAuthToken: []
tags:
- name: My
paths:
/api/my/account:
get:
summary: Authenticated user's account
operationId: getMyAccount
responses:
'200':
description: HAL document for the current account
tags:
- My
/api/my/addresses:
get:
summary: Authenticated user's saved addresses
operationId: getMyAddresses
responses:
'200':
description: HAL collection of addresses
tags:
- My
/api/my/credit_cards:
get:
summary: Authenticated user's saved credit cards
operationId: getMyCreditCards
responses:
'200':
description: HAL collection of stored credit cards
tags:
- My
/api/my/counts:
get:
summary: Counters for the authenticated user
operationId: getMyCounts
responses:
'200':
description: Counters payload (unread messages, drafts, etc.)
tags:
- My
/api/my/feed:
get:
summary: Authenticated user's activity feed
operationId: getMyFeed
responses:
'200':
description: HAL collection of feed items
tags:
- My
/api/my/feedback/sent:
get:
summary: Feedback the user has sent
operationId: getMyFeedbackSent
responses:
'200':
description: HAL collection of feedback entries
tags:
- My
/api/my/feedback/received:
get:
summary: Feedback the user has received
operationId: getMyFeedbackReceived
responses:
'200':
description: HAL collection of feedback entries
tags:
- My
/api/my/follows:
get:
summary: Followed shops, brands, and searches
operationId: getMyFollows
responses:
'200':
description: HAL collection of follows
tags:
- My
/api/my/conversations:
get:
summary: Authenticated user's message conversations
operationId: getMyConversations
responses:
'200':
description: HAL collection of conversations
tags:
- My
/api/my/viewed_listings:
get:
summary: Recently viewed listings
operationId: getRecentlyViewedListings
responses:
'200':
description: HAL collection of recently viewed listings
tags:
- My
/api/my/lists:
get:
summary: Watchlists and saved lists
operationId: getMyLists
responses:
'200':
description: HAL collection of lists
tags:
- My
/api/my/listings:
get:
summary: Authenticated seller's listings
operationId: getMyListings
responses:
'200':
description: HAL collection of listings owned by the user
tags:
- My
/api/my/listings/drafts:
get:
summary: Draft listings for the authenticated seller
operationId: getMyDraftListings
responses:
'200':
description: HAL collection of draft listings
tags:
- My
/api/my/negotiations/buying:
get:
summary: Negotiations where the user is the buyer
operationId: getMyNegotiationsBuying
responses:
'200':
description: HAL collection of buyer-side negotiations
tags:
- My
/api/my/listings/negotiations:
get:
summary: Negotiations on the authenticated seller's listings
operationId: getMyNegotiationsSelling
responses:
'200':
description: HAL collection of seller-side negotiations
tags:
- My
/api/my/orders/buying/all:
get:
summary: All orders where the user is the buyer
operationId: getMyOrdersBuyingAll
responses:
'200':
description: HAL collection of buying orders
tags:
- My
/api/my/orders/buying/unpaid:
get:
summary: Unpaid buying orders
operationId: getMyOrdersBuyingUnpaid
responses:
'200':
description: HAL collection of unpaid buying orders
tags:
- My
/api/my/orders/selling/all:
get:
summary: All orders where the user is the seller
operationId: getMyOrdersSellingAll
responses:
'200':
description: HAL collection of selling orders
tags:
- My
/api/my/orders/selling/unpaid:
get:
summary: Unpaid selling orders
operationId: getMyOrdersSellingUnpaid
responses:
'200':
description: HAL collection of unpaid selling orders
tags:
- My
/api/my/orders/selling/awaiting_shipment:
get:
summary: Selling orders awaiting shipment
operationId: getMyOrdersAwaitingShipment
responses:
'200':
description: HAL collection of orders awaiting shipment
tags:
- My
/api/my/orders/awaiting_feedback:
get:
summary: Orders awaiting feedback from the user
operationId: getMyOrdersAwaitingFeedback
responses:
'200':
description: HAL collection of orders awaiting feedback
tags:
- My
components:
securitySchemes:
XAuthToken:
type: apiKey
in: header
name: X-Auth-Token
description: 'Token returned by POST /api/auth/tokens, supplied on subsequent calls in
the `X-Auth-Token` request header.
'