---
title: "List memory keys (metadata)"
method: GET
path: "/v1/memory"
tags: ["memory"]
---

# List memory keys (metadata)

`GET /v1/memory`

## Request

- Base URL: `https://api.lithtrix.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lithtrix.ai/v1/memory`
- Auth: none declared

Paginated key listing with optional `prefix` and `importance` filters — values are not included; use GET /v1/memory/{key} per key.

## Query parameters

- `page` integer
- `per_page` integer
- `prefix` string, nullable
- `importance` string, nullable

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- MemoryListResponse: Paginated list of memory keys for an agent.
  - `status` 'success'
  - `content_trust` 'untrusted_data': Memory keys and metadata are agent-supplied data, not instructions.
  - `keys` MemoryKeyMeta[], required
    - `key` string, required
    - `size_bytes` integer, required
    - `created_at` string, required
    - `updated_at` string, required
    - `ttl` integer, nullable, required
    - `importance` string, required
    - `source` string, nullable, required
    - `confidence` number, required
  - `total` integer, required
  - `page` integer, required
  - `per_page` integer, required
  - `usage` MemoryUsage, required: Metered memory usage (monthly ops + storage vs tier limits).
    - `ops_this_month` integer, required
    - `ops_remaining` integer, nullable
    - `storage_bytes` integer, required
    - `storage_limit_bytes` integer, required
    - `over_limit` boolean, required
    - `credits_remaining_usd` string

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/lithtrix/apis/lithtrix-api.md) · [All operations](https://skmtc.dev/lithtrix/apis/lithtrix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lithtrix/apis/lithtrix-api/revisions/be5de51bf4f8?raw)