---
title: "Get Memory Store"
method: GET
path: "/v2/memory-stores/{memory_store_id}"
tags: ["Memory Stores"]
---

# Get Memory Store

`GET /v2/memory-stores/{memory_store_id}`

## Request

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

Returns the pinned and learned memory for one store.

## Response `200`

Memory store returned

- MemoryStore
  - `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.
  - `pinned_memories` PinnedMemory[], required: Pinned facts in this store.
    - `memory_id` string, required: Unique identifier for the pinned memory.
    - `memory` string, required: Pinned fact.
    - `created_at` string, required: When the pinned memory was created.
    - `updated_at` string, required: When the pinned memory was last updated.
  - `learned` LearnedMemory, required: Memory learned from prior conversations. A filtered request may return only profile or timeline.
    - `profile` object: Structured participant information learned across conversations, nested up to three levels.
    - `timeline` object: Time-aware interaction history grouped into recent conversations, days, weeks, and months.
  - `created_at` string, required: When the store was created.
  - `updated_at` string, required: When the store was last updated.

## Other responses

- `401`: Unauthorized
- `403`: The caller does not own this memory store
- `404`: Memory store not found

## Changes

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

[Operation history](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/changes/v2/memory-stores/:memory_store_id/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)