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

# List Memory Stores

`GET /v2/memory-stores`

## Request

- Base URL: `https://tavusapi.com`
- URL: `https://tavusapi.com/v2/memory-stores`
- Auth: API key in header `x-api-key`

Lists memory stores owned by the caller. Filter by `pal_id`, `participant_tag`, or both. The returned `memory_store_id` is the resource identifier for reading, editing, or deleting the store; conversation creation uses `participant_tags` instead.

## Query parameters

- `pal_id` string
- `participant_tag` string

## Response `200`

Memory stores returned

- object
  - `data` MemoryStoreSummary[], required
    - `memory_store_id` string, required: Unique identifier for the memory store.
    - `pal_id` string, required: PAL this store belongs to.
    - `participant_tag` string, required: Developer-provided participant identifier.

## Other responses

- `400`: Bad Request - invalid query parameters
- `401`: Unauthorized

## Changes

- **2026-11-03** `932c24e63be2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/changes/v2/memory-stores/get.md)

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) - [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/revisions/60c89a007146?raw)