docs: add UserWantToPlayList endpoint

README.md

@@ -43,6 +43,7 @@ Click the function names to open their complete docs on the docs site.
 - [Recently Played Games](https://api-docs.retroachievements.org/v1/get-user-recently-played-games.html) - Get a list of games a user has recently played.
 - [Summary](https://api-docs.retroachievements.org/v1/get-user-summary.html) - Get a user's profile metadata.
 - [Completed Games](https://api-docs.retroachievements.org/v1/get-user-completed-games.html) - Legacy endpoint. Get hardcore and softcore completion metadata about games a user has played.
+- [Want to Play Games List](https://api-docs.retroachievements.org/v1/get-user-want-to-play-list.html) - Get a user's list of Want to Play Games.
 
 ### Game
 

docs/.vitepress/config.mts

@@ -106,6 +106,10 @@ export default defineConfig({
             text: "Completed Games",
             link: "/v1/get-user-completed-games",
           },
+          {
+            text: "Want to Play Games List",
+            link: "/v1/get-user-want-to-play-list",
+          },
         ],
       },
       {

docs/v1/get-user-want-to-play-list.md

@@ -0,0 +1,64 @@
+<script setup>
+import SampleRequest from '../components/SampleRequest.vue';
+</script>
+
+# User Want to Play List
+
+A call to this endpoint will retrieve a given user's "Want to Play Games" list, targeted by their username. Results will only be returned if the target user is yourself, or if both you and the target user follow each other.
+
+[[toc]]
+
+## On-site Representation
+
+The user's Want to Play Games list page looks like:
+
+![Want to Play Games List](/want-to-play-list.png)
+
+## HTTP Request
+
+<SampleRequest httpVerb="GET">https://retroachievements.org/API/API_GetUserWantToPlayList.php?u=MaxMilyin</SampleRequest>
+
+### Query Parameters
+
+| Name | Required? | Description                                                  |
+| :--- | :-------- | :----------------------------------------------------------- |
+| `z`  | Yes       | Your username.                                               |
+| `y`  | Yes       | Your web API key.                                            |
+| `u`  | Yes       | The target username.                                         |
+| `c`  |           | Count, number of records to return (default: 100, max: 500). |
+| `o`  |           | Offset, number of entries to skip (default: 0).              |
+
+## Client Library
+
+Not yet supported.
+
+## Response
+
+::: code-group
+
+```json [HTTP Response]
+{
+  "Count": 100,
+  "Total": 1287,
+  "Results": [
+    {
+      "GameID": 20246,
+      "Title": "~Hack~ Knuckles the Echidna in Sonic the Hedgehog",
+      "ImageIcon": "/Images/074560.png",
+      "ConsoleID": 1,
+      "ConsoleName": "Genesis/Mega Drive",
+      "PointsTotal": 1500,
+      "AchievementsPublished": 50
+    }
+    // ...
+  ]
+}
+```
+
+:::
+
+## Source
+
+| Repo  | URL                                                                                             |
+| :---- | :---------------------------------------------------------------------------------------------- |
+| RAWeb | https://github.com/RetroAchievements/RAWeb/blob/master/public/API/API_GetUserWantToPlayList.php |