diff --git a/README.md b/README.md
index ade21766..1bd80777 100644
--- a/README.md
+++ b/README.md
@@ -308,6 +308,67 @@ try {
 
 [action attempt]: https://docs.seam.co/latest/core-concepts/action-attempts
 
+### Pagination
+
+Some Seam API endpoints that return lists of resources support pagination.
+Use the `SeamPaginator` class to fetch and process resources across multiple pages.
+
+#### Manually fetch pages with the nextPageCursor
+
+```ts
+const pages = seam.createPaginator(
+  seam.devices.list({
+    limit: 20
+  })
+)
+
+const [devices, { hasNextPage, nextPageCursor }] = await pages.firstPage()
+
+if (hasNextPage) {
+  const [moreDevices] = await pages.nextPage(nextPageCursor)
+}
+```
+
+#### Iterate over all pages
+
+```ts
+const pages = seam.createPaginator(
+  seam.devices.list({
+    limit: 20
+  })
+)
+
+for await (const devices of pages) {
+  console.log(`There are ${devices.length} devices on this page.`)
+}
+```
+
+#### Iterate over all resources
+
+```ts
+const pages = seam.createPaginator(
+  seam.devices.list({
+    limit: 20
+  })
+)
+
+for await (const device of pages.flatten()) {
+  console.log(devices.name)
+}
+```
+
+#### Return all resources across all pages as an array
+
+```ts
+const pages = seam.createPaginator(
+  seam.devices.list({
+    limit: 20
+  })
+)
+
+const devices = await pages.toArray()
+```
+
 ### Interacting with Multiple Workspaces
 
 Some Seam API endpoints interact with multiple workspaces.
diff --git a/src/lib/seam/connect/index.ts b/src/lib/seam/connect/index.ts
index 9d49daea..1f0abca1 100644
--- a/src/lib/seam/connect/index.ts
+++ b/src/lib/seam/connect/index.ts
@@ -16,6 +16,7 @@ export * from './seam-http-error.js'
 export * from './seam-http-multi-workspace.js'
 export * from './seam-http-request.js'
 export * from './seam-paginator.js'
+export * from './seam-paginator.js'
 export {
   isApiKey,
   isClientSessionToken,
diff --git a/src/lib/seam/connect/seam-paginator.ts b/src/lib/seam/connect/seam-paginator.ts
index d39aecbc..4b2af7fd 100644
--- a/src/lib/seam/connect/seam-paginator.ts
+++ b/src/lib/seam/connect/seam-paginator.ts
@@ -7,7 +7,7 @@ interface SeamPaginatorParent {
   readonly defaults: Required<SeamHttpRequestOptions>
 }
 
-interface Pagination {
+export interface Pagination {
   readonly hasNextPage: boolean
   readonly nextPageCursor: string | null
   readonly nextPageUrl: string | null