---
title: "List Memories"
method: GET
path: "/api/memory/list"
tags: ["memory"]
---

# List Memories

`GET /api/memory/list`

## Query parameters

- `category` string, nullable — Filter by category
- `tags` string, nullable — Comma-separated tags to filter
- `keywords` string, nullable — Comma-separated keywords to filter
- `date_from` string, date-time, nullable — Filter from this date
- `date_to` string, date-time, nullable — Filter to this date
- `search` string, nullable — Search query to filter memories by content
- `similarity_threshold` number, nullable — Similarity threshold for vector search (0.1-2.0)
- `limit` integer — Maximum results to return
- `offset` integer — Offset for pagination

## Response `200`

Successful Response

- MemoryListResponse
  - `memories` object[], required
  - `total_count` integer, required
  - `filters_used` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/xorbitsai/apis/xagent.md) · [All operations](https://skmtc.net/xorbitsai/apis/xagent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xorbitsai/xagent/revisions/33e4ba4936ad/schema)