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

# List memory stores

`GET /v2/memory-stores`

Retrieves a paginated list of memory stores in the workspace. Use cursor-based pagination parameters to navigate through the results.

## Query parameters

- `limit` integer — A limit on the number of objects to be returned. Limit can range between 1 and 50, and the default is 10
- `starting_after` string — A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, ending with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `after=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the next page of the list.
- `ending_before` string — A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, starting with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `before=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the previous page of the list.
- `search` string — Filter memory stores by key (case-insensitive match)
- `updated_by` string — Filter by the users who last updated the memory store. Accepts a comma-separated list of user IDs
- `project_id` string — Filter memory stores by project ID

## Response `200`

Successfully retrieved the list of memory stores.

- ListMemoryStoresResponse
  - `object` 'list', required
  - `data` MemoryStore[], required
    - `key` string, required — The unique key of the memory store. The key is unique and inmmutable and cannot be repeated within the same workspace.
    - `description` string, required — The description of the memory store. Be as precise as possible to help the AI to understand the purpose of the memory store.
    - `created_by_id` string, nullable — The user ID of the creator
    - `updated_by_id` string, nullable — The user ID of the last updater
    - `created` string, required — The creation date of the memory store
    - `updated` string, required — The last update date of the memory store
    - `ttl` number, nullable
    - `embedding_config` MemoryStoreEmbeddingConfig, required
      - `model` string, required — The embeddings model to use for the knowledge base in the format "provider/model" for public models or "workspaceKey@provider/model" for private workspace models. This model will be used to embed the chunks when they are added to the knowledge base. Refer to the (Supported models)[/docs/proxy/supported-models] to browse available models.
    - `_id` string, required — The unique identifier of the memory store
  - `has_more` boolean, required

## Other responses

- `401` — Unauthorized - Bearer token is missing or invalid.

---

[API](https://skmtc.net/orq-ai/apis/orq-ai-api.md) · [All operations](https://skmtc.net/orq-ai/apis/orq-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orq-ai/orq-ai-api/revisions/2cd7e7f7bcb4/schema)