---
title: "List memories."
method: GET
path: "/v1/memories"
---

# List memories.

`GET /v1/memories`

## Request

- Base URL: `https://api.cortexplus.io`
- URL: `https://api.cortexplus.io/v1/memories`
- Auth: HTTP bearer

List the account’s memories ordered by last update, or search them semantically with q. Supply changedSince to fetch memory changes since a sync token. Returns full nodes.

## Query parameters

- `limit` integer
- `offset` integer
- `changedSince` string
- `cursor` string
- `type` string
- `tag` string[]
- `client` string
- `q` string
- `mode` 'semantic' | 'text'
- `parentId` string
- `archived` 'false' | 'true' | 'all'

## Response `200`

Successful response.

- object
  - `items` object[], required
    - `relevance` object, nullable: Computed relevance (not stored): score 0-100, level, reason codes. null when no scorer applies.
      - `score` integer
      - `level` 'low' | 'normal' | 'high' | 'critical'
      - `reasons` string[]
      - `snoozedUntil` string, date, nullable
      - `aiDelta` integer
  - `limit` integer
  - `offset` integer
  - `removed` string[]
  - `nextCursor` string, nullable
  - `syncToken` string, nullable
  - `reset` boolean

## Other responses

- `default`: Request failed.

---

[API](https://skmtc.dev/cortexplus/apis/cortexplus-rest-api.md) · [All operations](https://skmtc.dev/cortexplus/apis/cortexplus-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cortexplus/apis/cortexplus-rest-api/revisions/2d04f1593663?raw)