---
title: "List memory items"
method: GET
path: "/api/v1/memory"
tags: ["memory"]
---

# List memory items

`GET /api/v1/memory`

Return memory items filtered by scope and scope_id. Without filters, returns all memory for the authenticated user.

## Query parameters

- `scope` string, nullable — Filter by memory scope (user, tenant, workspace, run, session).
- `scope_id` string, nullable — Filter by scope identifier.
- `limit` integer — Page size
- `offset` integer — Pagination offset

## Response `200`

Successful Response

- MemoryListResponse — Paginated memory item list response.
  - `items` MemoryItemResponse[], required — Memory item list items.
    - `id` string, required — Durable memory item identifier.
    - `scope` string, required — Memory scope (e.g. user, tenant, workspace, run, session).
    - `scope_id` string, required — Identifier within the scope.
    - `kind` string, required — Memory kind (e.g. fact, observation, preference).
    - `source` string, required — Memory source (e.g. user, agent, system).
    - `status` string, required — Memory status (e.g. active, archived).
    - `content_text` string, nullable — Textual content when available.
    - `importance` integer, required — Importance score (0-100).
    - `tags` string[] — Associated tags.
    - `created_at` string, required — ISO-8601 creation timestamp.
  - `total` integer, required — Total matching memory items.
  - `offset` integer, required — Current pagination offset.
  - `limit` integer, required — Current page size.
  - `has_more` boolean, required — Whether more results exist beyond this page.

## Other responses

- `400` — Invalid scope filter value.
- `401` — Authentication is required or the provided token is invalid.
- `422` — Validation Error
- `503` — Memory services are unavailable because server startup is incomplete.

## Changes

- **2026-04-25** `71505a7fb33f` — 1 info
  - added the required property `has_more` to the response with the `200` status
- **2026-04-24** `2f0177352606` — 2 info
  - added the new optional `query` request parameter `offset`
  - added the required property `offset` to the response with the `200` status
- **2026-04-23** `86c33e5b870d` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/qredence/apis/fleet-rlm/changes/api/v1/memory/get.md)

---

[API](https://skmtc.dev/qredence/apis/fleet-rlm.md) · [All operations](https://skmtc.dev/qredence/apis/fleet-rlm/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/qredence/fleet-rlm/revisions/b8ee197ef03e/schema)