---
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 — Optional filters to apply to the search. Can be a JSON string or Query object.
    - object
      - `OR` union[], required — Array of OR filter expressions
        - union — A logical filter expression that can combine conditions using AND/OR operations. Supports up to 5 levels of nesting.
          - object — 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` union[], required — OR: Array of conditions or nested expressions
              - …
          - object
            - `AND` union[], required — AND: Array of conditions or nested expressions
              - …
    - object
      - `AND` union[], required — Array of AND filter expressions
        - union — A logical filter expression that can combine conditions using AND/OR operations. Supports up to 5 levels of nesting.
          - object — 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` union[], required — OR: Array of conditions or nested expressions
              - …
          - object
            - `AND` union[], 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

## Changes

- **2026-04-07** `b5edd97adf4a` — 2 info
  - api tag `Content Management` added
  - api tag `Memories` removed
- **2026-04-06** `cb825424a780` — 2 info
  - api tag `Memories` added
  - api tag `Memories (v4)` removed
- **2026-03-15** `b40318167017` — 1 breaking
  - request body became required
- **2026-03-12** `7386f0fb8043` — 1 warning
  - changed the pattern of the request property `containerTags/items/` from `^[a-zA-Z0-9_-]+$` to `^[a-zA-Z0-9_:-]+$`
- **2026-03-09** `8d6903994bad` — 1 breaking, 1 warning
  - added the pattern `^[a-zA-Z0-9_-]+$` to the request property `containerTags/items/`
  - the `containerTags/items/` request property's maxLength was set to `100`

[Full history](https://skmtc.dev/supermemoryai/apis/supermemory-api/changes/v4/memories/list/post.md)

---

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