docs: add more examples

Author: stainless-app[bot]

README.md

@@ -131,6 +131,37 @@ On timeout, an `APIConnectionTimeoutError` is thrown.
 
 Note that requests which time out will be [retried twice by default](#retries).
 
+## Auto-pagination
+
+List methods in the Arcade API are paginated.
+You can use the `for await … of` syntax to iterate through items across all pages:
+
+```ts
+async function fetchAllUserConnectionResponses(params) {
+  const allUserConnectionResponses = [];
+  // Automatically fetches more pages as needed.
+  for await (const userConnectionResponse of client.admin.userConnections.list()) {
+    allUserConnectionResponses.push(userConnectionResponse);
+  }
+  return allUserConnectionResponses;
+}
+```
+
+Alternatively, you can request a single page at a time:
+
+```ts
+let page = await client.admin.userConnections.list();
+for (const userConnectionResponse of page.items) {
+  console.log(userConnectionResponse);
+}
+
+// Convenience methods are provided for manually paginating:
+while (page.hasNextPage()) {
+  page = await page.getNextPage();
+  // ...
+}
+```
+
 ## Advanced Usage
 
 ### Accessing raw Response data (e.g., headers)