---
title: "List memory entries with history"
method: POST
path: "/v4/memories/list"
tags: ["Content Management"]
---

# List memory entries with history

`POST /v4/memories/list`

List all latest memory entries from specified container tags with their update history and source documents

## Request body

- object — Query parameters for listing memory entries with history
  - `containerTags` string[], required — Container tags to filter memory entries. At least one tag is required.
  - `filters` union — Root query object that must contain either an AND or OR array of filter expressions
    - object
      - `OR` LogicalExpression[], required — Array of OR filter expressions
        - union — A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.
          - FilterCondition — A single filter condition based on metadata, numeric values, array contents, or string matching
            - `filterType` 'metadata' | 'numeric' | 'array_contains' | 'string_contains'
            - `key` string, required
            - `negate` union
              - …
            - `ignoreCase` union
              - …
            - `numericOperator` '>' | '<' | '>=' | '<=' | '='
            - `value` string, required
          - object
            - `OR` LogicalExpression[], required — OR: Array of conditions or nested expressions
          - object
            - `AND` LogicalExpression[], required — AND: Array of conditions or nested expressions
    - object
      - `AND` LogicalExpression[], required — Array of AND filter expressions
        - union — A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.
          - FilterCondition — A single filter condition based on metadata, numeric values, array contents, or string matching
            - `filterType` 'metadata' | 'numeric' | 'array_contains' | 'string_contains'
            - `key` string, required
            - `negate` union
              - …
            - `ignoreCase` union
              - …
            - `numericOperator` '>' | '<' | '>=' | '<=' | '='
            - `value` string, required
          - object
            - `OR` LogicalExpression[], required — OR: Array of conditions or nested expressions
          - object
            - `AND` LogicalExpression[], required — AND: Array of conditions or nested expressions
  - `limit` union — Number of items per page
    - string
    - number
  - `order` 'asc' | 'desc' — Sort order
  - `page` union — Page number to fetch
    - string
    - number
  - `sort` 'createdAt' | 'updatedAt' — Field to sort by

## Response `200`

Successfully retrieved memory entries

- object — List of memory entries with their history and source documents
  - `memoryEntries` object[], required
    - `id` string, required — Unique identifier for the memory entry
    - `memory` string, required — The memory content/text
    - `version` number, required — Version number of this memory
    - `isLatest` boolean, required — Whether this is the latest version
    - `isForgotten` boolean, required — Whether this memory has been forgotten
    - `isStatic` boolean, required — Whether this is a static profile memory
    - `isInference` boolean, nullable, required — Whether this is an inferred memory
    - `createdAt` string, required — ISO timestamp of creation
    - `updatedAt` string, required — ISO timestamp of last update
    - `spaceId` string, required — ID of the space this memory belongs to
    - `orgId` string, required — Organization ID
    - `sourceCount` number, required — Number of source documents for this memory
    - `parentMemoryId` string, nullable, required — ID of the parent memory (previous version)
    - `rootMemoryId` string, nullable, required — ID of the root memory (first version)
    - `forgetAfter` string, nullable, required — ISO timestamp when memory should be forgotten
    - `forgetReason` string, nullable, required — Reason for forgetting
    - `metadata` object, nullable, required — Metadata including temporal context and other information
    - `memoryRelations` object, nullable, required — Relations to other memories
    - `temporalContext` object, nullable, required — Temporal context metadata (alias for metadata field)
    - `history` object[], required — Previous versions of this memory
      - `id` string, required
      - `memory` string, required
      - `version` number, required
      - `createdAt` string, required
      - `updatedAt` string, required
      - `parentMemoryId` string, nullable, required
      - `rootMemoryId` string, nullable, required
      - `isLatest` boolean, required
      - `isForgotten` boolean, required
    - `documentIds` string[], required — IDs of source documents for this memory
  - `pagination` object, required — Pagination metadata
    - `currentPage` number, required
    - `limit` number
    - `totalItems` number, required
    - `totalPages` number, required

## Other responses

- `400` — Bad request - containerTags are required
- `401` — Unauthorized
- `500` — Internal server error

---

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