---
title: "List memory stores"
method: GET
path: "/v1/memory-stores"
tags: ["Agent Memory - Stores"]
---

# List memory stores

`GET /v1/memory-stores`

## Request

- Base URL: `https://api.redislabs.com`
- URL: `https://api.redislabs.com/v1/memory-stores`
- Auth: API key in header `x-api-key` and API key in header `x-api-secret-key` and API key in header `x-auth-token`

List the Agent Memory stores for the account

## Response `200`

Memory stores returned.

- MemoryStoreListResponse: List of memory stores
  - `data` MemoryStoreSummary[]
    - `storeId` string
    - `name` string
    - `createdAt` string, date-time
    - `databaseId` string
    - `databaseName` string
    - `subscriptionId` string
    - `extractionStrategy` 'INSTRUCT': How long-term memories are extracted from sessions. INSTRUCT uses LLM tool calling to create, update and delete granular memories
    - `summarization` MemoryStoreSummarizationConfig: Session summarization. When enabled, long sessions are periodically condensed into a running summary while the most recent events are retained. When omitted on create, nothing is stored and the store uses the deployment's default summarization settings, which GET returns as the store's summarization
      - `enabled` boolean, required: Whether summarization is enabled for the store. Required
      - `triggerStrategy` 'event_count': What triggers a summarization cycle. Defaults to event_count
      - `eventCount` MemoryStoreSummarizationThresholdConfig: Event-count trigger for session summarization. threshold must be greater than retainCount
        - `threshold` integer, required: Number of active session events that triggers a summarization cycle (0-10000). Must be greater than retainCount. Required
        - `retainCount` integer, required: Number of most recent events kept unsummarized after each cycle (0-10000); everything older is condensed into the running summary. Must be less than threshold. Required
    - `llm` MemoryStoreModelStatus: Resolved model in use for one purpose. Present only on stores with an explicit model selection
      - `provider` string: Model provider in use
      - `model` string: Model in use
    - `status` 'PROVISIONING' | 'READY' | 'UNAVAILABLE': Lifecycle status of the memory store

## Other responses

- `400`: Bad Request - The server cannot process the request due to something that is perceived to be a client error
- `401`: Unauthorized - Authentication failed for requested resource
- `403`: Forbidden - Not allowed to access requested resource (primarily due to client source IP API Key restrictions)
- `404`: Not Found - The resource you were trying to reach was not found or does not exist
- `408`: Request Timeout - The server didn't receive a complete request message within the server's allotted timeout period
- `409`: Conflict - request could not be processed because of a conflict (primarily due to another resource that exist with new updated name)
- `412`: Precondition Failed - Feature flag for this flow is off
- `424`: Failed Dependency - The memory store's database is unavailable or out of memory, e.g. /errors/resource-unavailable or /errors/database-out-of-memory. When the error originates from the Agent Memory service the body is an application/problem+json document (MemoryProblemDetails) carrying the service's error type and detail
- `429`: Too Many Requests - Too many resources are concurrently created / updated / deleted in the account. Please re-submit API requests after resource changes are completed)
- `500`: Internal system error - If this error persists, please contact customer support
- `503`: Service Unavailable - Server is temporarily unable to handle the request, please try again later. If this error persists, please contact customer support

## Changes

- **2026-10-02** `6b256e1bb946`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/redis/apis/redis-cloud-api/changes/v1/memory-stores/get.md)

---

[API](https://skmtc.dev/redis/apis/redis-cloud-api.md) - [All operations](https://skmtc.dev/redis/apis/redis-cloud-api/llms.txt) - [OpenAPI document](https://skmtc.dev/redis/apis/redis-cloud-api/revisions/5c114f33e7d5?raw)