---
title: "List memory stores"
method: GET
path: "/v1/projects/{projectSlug}/memory/stores"
tags: ["Memory"]
---

# List memory stores

`GET /v1/projects/{projectSlug}/memory/stores`

Returns a cursor-paginated page of the project's memory stores, one roll-up row each (record count, tokens, last-updated, sessions, users). A store groups records under `gen_ai.memory.store.id`; the empty-string store is the unattributed bucket.

## Path parameters

- `projectSlug` string, required — Project slug (human-readable identifier)

## Query parameters

- `cursor` string — Opaque cursor returned in a previous response's `nextCursor`. Omit on the first page.
- `limit` integer — Page size. Defaults to 50; max 200.
- `sort` 'lastUpdated' | 'lastRead' | 'records' | 'tokens' | 'sessions' | 'users' — Field to sort by. Defaults to `lastUpdated` (most recently written first).
- `direction` 'asc' | 'desc' — Sort direction. Defaults to `desc`.

## Response `200`

Page of memory stores

- PaginatedMemoryStores
  - `items` MemoryStore[], required — Page of items, in the requested sort order.
    - `storeId` string, required — Store identifier (`gen_ai.memory.store.id`). The empty string is the unattributed bucket.
    - `recordCount` integer, required — Number of live (non-deleted) records in the store.
    - `tokenCount` integer, required — Total tokens across the store's live record bodies.
    - `lastUpdatedAt` string, required — ISO-8601 timestamp of the store's most recent mutating write.
    - `lastReadAt` string, nullable, required — ISO-8601 timestamp of the store's most recent read. `null` when never read.
    - `sessionCount` integer, required — Number of distinct sessions that wrote to the store.
    - `userCount` integer, required — Number of distinct end-users who accessed the store.
  - `nextCursor` string, nullable, required — Opaque cursor for fetching the next page. `null` when there are no more pages. Pass it back in `cursor` to continue.
  - `hasMore` boolean, required — `true` when there is at least one more page after this one.

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/latitude-dev/apis/latitude.md) · [All operations](https://skmtc.net/latitude-dev/apis/latitude/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/latitude-dev/latitude/versions/6a8789c59a5c/schema)