From c6fce57b485456236436538a7f85952ee28cf7a7 Mon Sep 17 00:00:00 2001
From: Javier Cicchelli <javier@rock-n-code.com>
Date: Thu, 16 Oct 2025 19:23:33 +0200
Subject: [PATCH] Implemented the GET /users/{username}/lists endpoint for the
 Open API specification document in the library target.

---
 Sources/DiscogsService/openapi.yaml | 94 ++++++++++++++++++++++++++++-
 1 file changed, 92 insertions(+), 2 deletions(-)

diff --git a/Sources/DiscogsService/openapi.yaml b/Sources/DiscogsService/openapi.yaml
index be4fbad2e..ef1eeca5f 100644
--- a/Sources/DiscogsService/openapi.yaml
+++ b/Sources/DiscogsService/openapi.yaml
@@ -1601,13 +1601,13 @@ paths:
           content:
             application/json:
               schema: 
-                description: A type that contains a list of releases in a wantlist.
+                description: A type that contains a list of lists of a user.
                 type: object
                 properties:
                   pagination:
                     $ref: '#/components/schemas/Pagination'
                   wants:
-                    description: A list of releases in a wantlist.
+                    description: A list of lists of a user.
                     type: array
                     items:
                       $ref: '#/components/schemas/ReleaseInFolder'
@@ -1739,6 +1739,52 @@ paths:
           $ref: '#/components/responses/NotFound'
         '500':
           $ref: '#/components/responses/InternalError'
+  /users/{username}/lists:
+    get:
+      tags:
+        - User Lists
+      summary: Get a list of lists of a user.
+      description: |
+        Returns a list of lists created by a users.
+        
+        This endpoints accepts pagination and, to show private lists it is required to be authenticated as a owner.
+      operationId: getLists
+      parameters:
+        - $ref: '#/components/parameters/Username'
+        - $ref: '#/components/parameters/Page'
+        - $ref: '#/components/parameters/PerPage'
+      responses:
+        '200':
+          description: Successfully retrieved a list of lists of a user.
+          headers:
+            Link:
+              $ref: '#/components/headers/Link'
+            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 type that contains a list of lists of a user.
+                type: object
+                properties:
+                  pagination:
+                    $ref: '#/components/schemas/Pagination'
+                  lists:
+                    description: A list of lists of a user.
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/ListId'
+                required:
+                  - lists
+                  - pagination
+        '404':
+          $ref: '#/components/responses/NotFound'
+        '500':
+          $ref: '#/components/responses/InternalError'
 components:
   headers:
     Link:
@@ -2555,6 +2601,50 @@ components:
           properties:
             type:
               enum: [label]
+    ListId:
+      description: A type that references a list.
+      type: object
+      properties:
+        id: 
+          description: An identifier of a list.
+          type: integer
+          minimum: 0
+          readOnly: true
+        uri:
+          description:  A URI representation of a list.
+          type: string
+          format: uri
+        resource_url:
+          description: A URI resource of a list.
+          type: string
+          format: uri
+          readOnly: true
+        name:
+          description: A name of a list.
+          type: string
+        description:
+          description: A descriptive explanation of a list.
+          type: string
+        public:
+          description: A flag that indicates whether a list is public or not.
+          type: boolean
+        date_added:
+          description: A date and time in which a list was created.
+          type: string
+          format: date-time
+        date_changed:
+          description: A date and time in which a list was last changed.
+          type: string
+          format: date-time
+      required:
+        - date_added
+        - date_changed
+        - description
+        - id
+        - name
+        - public
+        - resource_url
+        - uri
     Master:
       description: A type that represents a set of similar releases.
       type: object