---
title: "List Memories"
method: GET
path: "/memories"
tags: ["Memories"]
---

# List Memories

`GET /memories`

## Request

- Base URL: `https://api.getmetacognition.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getmetacognition.com/memories`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/metacognition/apis/tex-api/docs/memories/get.ts> (a function with typed inputs; its response is checked against the schema)

List stored memories with pagination and optional type/label filters.

Scoped to the current tenant.

## Query parameters

- `limit` integer
- `offset` integer
- `type` string, nullable: Filter by type: document, episode, preference
- `label` string, nullable: Filter by graph label

## Response `200`

Successful Response

- MemoryListResponse: Paginated list of memories.
  - `memories` MemoryResponse[]
    - `id` string, required: Memory ID (UUID)
    - `user_id` string, nullable: Owner user ID
    - `type` string: Memory type: document, episode, preference
    - `label` string: Graph label
    - `content` string, nullable: Text content or summary
    - `status` string: Lifecycle status
    - `metadata` object, nullable: Additional properties
    - `created_at` string, nullable: Creation timestamp (ISO)
    - `updated_at` string, nullable: Last update timestamp (ISO)
    - `contexts` string[], nullable: Context sentences the entity appeared in (GET by id only; additive)
    - `inferences` string[], nullable: Inference text generated for this node (GET by id only; additive)
  - `count` integer: Number of items returned
  - `next_offset` integer: Offset for next page

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/metacognition/apis/tex-api.md) - [All operations](https://skmtc.dev/metacognition/apis/tex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metacognition/apis/tex-api/revisions/3bef47e50f2e?raw)