> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getmodus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Page

> Paginated list result.

Paginated list result. Async clients use `AsyncPage` (same shape with `async` methods).

### Page

```python
class Page(items: List[T], next_page_token: str | None, _fetch_page: Callable[[str], Page[T]])
```

Bases: `Generic`\[`T`]

A single page of results from a Modus list endpoint (sync).

Iterating yields the **current** page only. Use `auto_paging_iter()` to walk every page, or `get_next_page()` to advance manually.

For async clients, see `AsyncPage`.

#### has\_next\_page()

```python
has_next_page() → bool
```

Return True if more pages are available.

#### get\_next\_page()

```python
get_next_page() → Page[T]
```

Fetch and return the next page. Raises ValueError if no next page.

#### auto\_paging\_iter()

```python
auto_paging_iter() → Iterator[T]
```

Iterate over all items across all pages, fetching lazily as needed.

Warning: may make multiple API calls for large result sets.

### AsyncPage

```python
class AsyncPage(items: List[T], next_page_token: str | None, _fetch_page: Callable[[str], Awaitable[AsyncPage[T]]])
```

Bases: `Generic`\[`T`]

A single page of results from a Modus list endpoint (async).

#### has\_next\_page()

```python
has_next_page() → bool
```

Return True if more pages are available.

#### get\_next\_page()

```python
async get_next_page() → AsyncPage[T]
```

Fetch and return the next page. Raises ValueError if no next page.

#### auto\_paging\_iter()

```python
async auto_paging_iter() → AsyncIterator[T]
```

Async-iterate over all items across all pages, fetching lazily as needed.

* Usage:

  * async for item in page.auto\_paging\_iter():

    process(item)