---
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 200, 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.

- object
  - `object` 'list', required
  - `data` object[], required
    - `_id` string, required — The unique identifier of the memory store
    - `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 — The default time to live of every memory document created within the memory store. Useful to control if the documents in the memory should be store for short or long term.
    - `embedding_config` object, 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.
  - `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/versions/41c02aedc7c0/schema)