---
title: "List notes"
method: GET
path: "/notes"
tags: ["Notes"]
---

# List notes

`GET /notes`

## Request

- Base URL: `https://app.cleve.ai/api/v1`
- URL: `https://app.cleve.ai/api/v1/notes`
- Auth: HTTP bearer

Lists notes in the workspace, newest first. `content` is a short plain-text preview; call getNote for the full body.

## Query parameters

- `folderId` string
- `pinnedOnly` boolean

## Response `200`

The notes.

- object
  - `data` NoteSummary[], required
    - `_id` string, required: Note ID.
    - `_creationTime` number, required: Creation time, milliseconds since the Unix epoch.
    - `userId` string: ID of the note's owner.
    - `title` string
    - `content` string, required: Plain-text preview of the body.
    - `kind` 'note' | 'memory' | 'welcome' | 'imported': `memory` notes hold what Cleve remembers about you; `imported` notes came from an import.
    - `isPinned` boolean, required
    - `isPublic` boolean: Whether link sharing is on.
    - `isPublished` boolean: Whether the note is published to the web.
    - `publishedAt` number: Publish time, milliseconds since the Unix epoch.
    - `folderId` string: Folder the note is in, if any.
    - `updatedAt` number, required: Last update, milliseconds since the Unix epoch.
    - `orgId` string: Workspace ID.

## Other responses

- `401`: Missing or invalid API key.
- `500`: Unexpected server error. Safe to retry once.

---

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