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

# ListMemoriesOptions

> Pagination and filtering options for retrieving sets of memories.

## Overview

The `ListMemoriesOptions` interface provides control over the retrieval of multiple memory records, enabling pagination and broad filtering across the memory store.

***

## Properties

| Property | Type | Description |
| :- | :- | :- |
| `type` | [`MemoryType`](../types/MemoryType) | **Optional.** Restricts the list to specific memory classifications (e.g., `episodic`). |
| `filter` | `string` | **Optional.** Structured filter criteria. User metadata fields must be prefixed with `m.` / `metadata.` (for example `m.source = "chat_v3"`). Unsupported fields are rejected. |
| `page_num` | `number` | **Optional.** The specific page index to retrieve (defaults to 1). |
| `page_size` | `number` | **Optional.** The number of records to return per page. |

***

## Usage Example

```typescript theme={null}
import { ListMemoriesOptions } from '@memmachine/client';

const options: ListMemoriesOptions = {
  type: 'episodic',
  filter: 'm.source = "chat_v3"',
  page_num: 2,
  page_size: 20
};

const history = await memory.list(options);
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.