---
title: "List coach long-term memories"
method: GET
path: "/api/memory"
tags: ["Memory"]
---

# List coach long-term memories

`GET /api/memory`

## Request

- Base URL: `https://api.setluca.com`
- URL: `https://api.setluca.com/api/memory`
- Auth: one of:
  - API key in cookie `luca.session_token`
  - API key in header `x-api-key`
  - HTTP bearer

Filter what Luca remembers by scope, lead, state, source, trust level, or a free-text search. Archived memories are left out unless you ask for them.

**API key scopes:** `memory:read`.

## Query parameters

- `scope` 'all' | 'coach' | 'lead'
- `source` string
- `q` string
- `leadId` string, uuid
- `archived` 'all' | 'active' | 'archived'
- `state` 'active' | 'archived' | 'disputed' | 'superseded' | 'all'
- `trustLevel` 'manual' | 'trusted_pipeline' | 'inferred' | 'disputed'

## Headers

- `Luca-API-Version` '1'

## Response `200`

ok

- MemoryListResponse
  - `memories` object[], required
    - `id` string, uuid, required
    - `content` string, required
    - `source` string, required
    - `sourceRefId` string, nullable, required
    - `confidence` number, required
    - `metadata` object, required
    - `createdByType` 'coach' | 'agent' | 'system', required
    - `createdById` string, nullable, required
    - `reason` string, nullable, required
    - `evidence` object, required
    - `trustLevel` 'manual' | 'trusted_pipeline' | 'inferred' | 'disputed', required
    - `supersedesMemoryId` string, uuid, nullable, required
    - `supersededAt` string, nullable, required
    - `disputedAt` string, nullable, required
    - `disputedReason` string, nullable, required
    - `leadId` string, uuid, nullable, required
    - `archivedAt` string, nullable, required
    - `factOrigin` 'profile_text' | 'coach_edit' | 'lead_message' | 'null', nullable, required
    - `sourceField` string, nullable, required
    - `createdAt` string, required
    - `updatedAt` string, required

## Other responses

- `400`: bad request
- `401`: unauthorized
- `429`: rate limited
- `500`: internal error
- `503`: service unavailable

---

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