Skip to main content
GET
List notes
Without q, pinned notes come first, then the most recently changed. With q, only the notes that contain any of its words (in the title, body, tags, or topic) come back, best match first, at most the best 200. See Search. topic keeps the notes with that topic, tag the notes with that tag, and pinned the pinned (true) or unpinned (false) ones. They combine with q and with each other. Each note comes in full, with the fields of Get a note. Needs notes:read. MCP tool: list_notes.

Authorizations

Authorization
string
header
required

API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.

Query Parameters

q
string
default:""

Words to search for in the title, body, tags and topic. Matches come best first.

Maximum string length: 200
topic
string | null

Only notes with this topic.

Maximum string length: 64
tag
string | null

Only notes with this tag.

Maximum string length: 40
pinned
boolean | null

Only pinned notes (true) or unpinned ones (false).

limit
integer
default:100

Items per page, 1–100.

Required range: 1 <= x <= 100
cursor
string | null

next_cursor of the previous page.

Response

A page of your notes.

notes
Note · object[]
required
has_more
boolean
required
read-only

True when there is a next page (next_cursor is not null).

next_cursor
string | null

Pass as ?cursor= for the next page; null on the last page.