---
title: "List memories"
method: GET
path: "/api/v1/agent/memories"
tags: ["agentApiMemories"]
---

# List memories

`GET /api/v1/agent/memories`

Lists memories accessible to the agent. By default returns:
- Memories about the specified subject (cross-agent sharing)
- Organization-wide shared memories

Use `scope` parameter to filter by visibility.
Use `content_query` for full-text search across memory content.

**Pagination:** Use `cursor` + `limit` (recommended) OR `page` + `page_size` (deprecated, sunset 2026-10-01).
Do NOT mix families.

## Query parameters

- `cursor` string
- `limit` integer
- `page` integer
- `subject_id` string
- `scope` string
- `system` string
- `type` string
- `segment` string
- `content_query` string
- `page_size` integer
- `status` string

## Headers

- `X-API-Key` string, required

## Response `200`

Memories

- MemoriesListAgentMemoriesResponse200 — unresolved $ref

## Other responses

- `401` — Unauthorized
- `422` — Invalid pagination params (invalid/unsupported cursor, or mixed cursor + offset families)

---

[API](https://skmtc.dev/band/apis/request-api.md) · [All operations](https://skmtc.dev/band/apis/request-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/band/request-api/revisions/6cdae3febf9d/schema)