diff --git a/doc/specs/tags/users/api-player-top-nb-perfType.yaml b/doc/specs/tags/users/api-player-top-nb-perfType.yaml
index 0c24a696..69a6fc18 100644
--- a/doc/specs/tags/users/api-player-top-nb-perfType.yaml
+++ b/doc/specs/tags/users/api-player-top-nb-perfType.yaml
@@ -39,6 +39,16 @@ get:
           - racingKings
           - threeCheck
       required: true
+    - in: query
+      name: offset
+      description: How many of the top players to optionally skip before getting `nb` users. Must be divisible by 100.
+      schema:
+        type: integer
+        minimum: 0
+        maximum: 1900
+        default: 0
+        example: 0
+      required: false
   responses:
     "200":
       description: The list of top players for the variant.
diff --git a/scripts/update-examples/users.ts b/scripts/update-examples/users.ts
index f465f437..3a7031fb 100644
--- a/scripts/update-examples/users.ts
+++ b/scripts/update-examples/users.ts
@@ -26,6 +26,9 @@ example(
         nb: 3,
         perfType: "blitz",
       },
+      query: {
+        offset: 0,
+      },
     },
   }),
 );