2025-11-10 00:34:40 +00:00
1 changed files with 65 additions and 0 deletions
@@ -2275,6 +2275,43 @@ paths:
          $ref: '#/components/responses/Unauthorized'
        '500':
          $ref: '#/components/responses/InternalError'
+  /marketplace/price_suggestions/{release_id}:
+    get:
+      tags:
+        - Marketplace
+      summary: Get some price suggestions for a given release.
+      description: |
+        Retrieves price suggestions for a provided release. If no suggestions are available, an empty object will be returned.
+
+        This endpoints requires authentication and also, the user should to have filled out the seller settings. Suggested prices will be denominated in the user's selling currency.
+      operationId: getPriceSuggestions
+      parameters:
+        - $ref: '#/components/parameters/ReleaseId'
+      security:
+        - ConsumerKeySecret: []
+        - UserToken: []
+        - OAuth: []
+      responses:
+        '200':
+          description: Successfully retrieved price suggestions for a given release.
+          headers:
+            X-Discogs-RateLimit:
+              $ref: '#/components/headers/RateLimit'
+            X-Discogs-RateLimit-Used:
+              $ref: '#/components/headers/RateLimitUsed'
+            X-Discogs-RateLimit-Remaining:
+              $ref: '#/components/headers/RateLimitRemaining'
+          content:
+            application/json:
+              schema:
+                description: A group of price suggestions for a release.
+                $ref: '#/components/schemas/ReleasePriceSuggestions'
+        '401':
+          $ref: '#/components/responses/Unauthorized'
+        '404':
+          $ref: '#/components/responses/NotFound'
+        '500':
+          $ref: '#/components/responses/InternalError'
 components:
  headers:
    Link:
@@ -4223,6 +4260,34 @@ components:
      required:
        - instance_id
        - resource_url
+    ReleasePriceSuggestions:
+      description: A typa the represents a list of price suggestions of a release.
+      type: object
+      properties:
+        "Mint (M)":
+          description: A suggested price for a release in mint condition, if any.
+          $ref: '#/components/schemas/Price'
+        "Near Mint (NM or M-)":
+          description: A suggested price for a release in near mint condition, if any.
+          $ref: '#/components/schemas/Price'
+        "Very Good Plus (VG+)":
+          description: A suggested price for a release in very good + condition, if any.
+          $ref: '#/components/schemas/Price'
+        "Very Good (VG)":
+          description: A suggested price for a release in very good condition, if any.
+          $ref: '#/components/schemas/Price'
+        "Good Plus (G+)":
+          description: A suggested price for a release in good + condition, if any.
+          $ref: '#/components/schemas/Price'
+        "Good (G)":
+          description: A suggested price for a release in good condition, if any.
+          $ref: '#/components/schemas/Price'
+        "Fair (F)":
+          description: A suggested price for a release in fair condition, if any.
+          $ref: '#/components/schemas/Price'
+        "Poor (P)":
+          description: A suggested price for a release in poor condition, if any.
+          $ref: '#/components/schemas/Price'
    ReleaseFormat:
      description: A type that represents a format of a release.
      type: object