From e5f043008782c5dd4e8d3ac42e49c42f73f72ac7 Mon Sep 17 00:00:00 2001
From: Javier Cicchelli <javier@rock-n-code.com>
Date: Mon, 10 Nov 2025 00:45:31 +0100
Subject: [PATCH] Implemented the GET
 /marketplace/price_suggestions/{release_id} endpoint for the Open API
 specification document in the library target.

---
 Sources/DiscogsService/openapi.yaml | 65 +++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)

diff --git a/Sources/DiscogsService/openapi.yaml b/Sources/DiscogsService/openapi.yaml
index dc1375669..72daf1469 100644
--- a/Sources/DiscogsService/openapi.yaml
+++ b/Sources/DiscogsService/openapi.yaml
@@ -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