> ## 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);
```