From b8f5c4bad3d5ea5314208a123888879fd4ab31fa Mon Sep 17 00:00:00 2001
From: Javier Cicchelli <javier@rock-n-code.com>
Date: Thu, 9 Oct 2025 16:48:53 +0200
Subject: [PATCH] Implemented the GET /releases/{release-id} endpoint for the
 Open API specification documentation in the library target.

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

diff --git a/Sources/DiscogsService/openapi.yaml b/Sources/DiscogsService/openapi.yaml
index cb696ff91..1c92f8eef 100644
--- a/Sources/DiscogsService/openapi.yaml
+++ b/Sources/DiscogsService/openapi.yaml
@@ -388,7 +388,7 @@ paths:
     get:
       tags:
         - Database
-      summary: Get master release versions
+      summary: Get information about the versions of a master release.
       description: |
         Retrieves a list of all releases that are versions of the specified master release. 
         
@@ -423,6 +423,25 @@ paths:
                       $ref: '#/components/schemas/ReleaseVersion'
         '404':
           $ref: '#/components/responses/NotFound'
+  /releases/{release_id}:
+    get:
+      tags:
+        - Database
+      summary: Get information about a release
+      description: Retrieves details for a specific release.
+      operationId: getRelease
+      parameters:
+        - $ref: '#/components/parameters/ReleaseId'
+        - $ref: '#/components/parameters/Currency'
+      responses:
+        '200':
+          description: Successfully retrieved release details.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Release'
+        '404':
+          $ref: '#/components/responses/NotFound'
 components:
   schemas:
     Artist:
@@ -620,6 +639,22 @@ components:
         - status
         - submitter
         - want
+    Currency:
+      description: A list of currency codes defined in the marketplace.
+      type: string
+      enum: 
+        - USD
+        - GBP
+        - EUR
+        - CAD
+        - AUD
+        - JPY
+        - CHF
+        - MXN
+        - BRL
+        - NZD
+        - SEK
+        - ZAR
     Identifier:
       description: A type that represents an identifier.
       type: object
@@ -1231,6 +1266,15 @@ components:
       in: query
       schema:
         type: string    
+    Currency:
+      description: |
+        A currency code in the marketplace. 
+
+        Defaults to the authenticated users currency.
+      name: curr_abbr
+      in: query
+      schema:
+        $ref: '#/components/schemas/Currency'
     Format:
       description: A filter by format.
       name: format
@@ -1295,6 +1339,14 @@ components:
       in: query
       schema:
         type: string    
+    ReleaseId:
+      description: An identifier of a release.
+      name: release_id
+      in: path
+      required: true
+      schema:
+        type: integer
+      example: 249504
     SortOrder:
       description: The order to sort the results. 
       name: sort_order