From 45ee53e1456946ee9dc42ea32da6ce064d4cc118 Mon Sep 17 00:00:00 2001
From: Javier Cicchelli <javier@rock-n-code.com>
Date: Sun, 9 Nov 2025 22:58:33 +0100
Subject: [PATCH] Implemented the GET /marketplace/orders/{order_id} endpoint
 for the Open API specification document in the library target.

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

diff --git a/Sources/DiscogsService/openapi.yaml b/Sources/DiscogsService/openapi.yaml
index 7a85a5b09..1c0c801a3 100644
--- a/Sources/DiscogsService/openapi.yaml
+++ b/Sources/DiscogsService/openapi.yaml
@@ -2064,6 +2064,42 @@ paths:
                   - pagination
         '500':
           $ref: '#/components/responses/InternalError'
+  /marketplace/orders/{order_id}:
+    get:
+      tags:
+        - Marketplace
+      summary: Get an order for a seller in a marketplace.
+      description: |
+        Views the data associated with an order.
+
+        This endpoints requires authentication as a seller.
+      operationId: getOrder
+      parameters:
+        - $ref: '#/components/parameters/OrderId'
+      security:
+        - ConsumerKeySecret: []
+        - UserToken: []
+        - OAuth: []
+      responses:
+        '200':
+          description: Successfully retrieved an order for a seller from a marketplace.
+          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:
+                $ref: '#/components/schemas/Order'
+        '401':
+          $ref: '#/components/responses/Unauthorized'
+        '403':
+          $ref: '#/components/responses/NotAccessable'
+        '500':
+          $ref: '#/components/responses/InternalError'
 components:
   headers:
     Link:
@@ -2317,6 +2353,14 @@ components:
       schema:
         type: string
         format: date-time
+    OrderId:
+      description: An identifier of an order.
+      name: order_id
+      in: path
+      required: true
+      schema:
+        type: integer
+        minimum: 0
     OrderStatus:
       description: An indication to show order with a given status only.
       name: status