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

# List notes

`GET /v1/vault/notes`

## Request

- Base URL: `https://api.hyperresearch.ai`
- URL: `https://api.hyperresearch.ai/v1/vault/notes`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `hr_session`

Notes in the workspace vault. Each row carries its raw `tags` and a parallel `display_tags` array of `{tag, label, kind}`, where a project scope tag resolves to the project name and a run tag to the question that run asked (E2E5-08); every tag has a label, and `kind` separates a subject from a scope key (E2E6-12). `display_title` is the title to show (E2E6-07), and `display_summary` is the excerpt to show beside it — the stored `summary` with the source site’s own chrome removed, or null when it held nothing else (E2E14-01). `summary` itself is returned unchanged, because it is editable.

## Query parameters

- `status` string
- `tag` string
- `type` string
- `parent` string
- `run_id` string
- `sort` 'created' | 'updated' | 'quality' | 'title'
- `limit` integer
- `cursor` integer, nullable

## Response `200`

Notes

- object
  - `notes` unknown[], required
    - unknown
  - `cursor` number, nullable, required

## Other responses

- `400`: Invalid request
- `401`: Authentication failed
- `403`: Insufficient scope or plan
- `404`: Not found
- `429`: Rate limited or over quota
- `500`: Internal error

---

[API](https://skmtc.dev/hyperresearch/apis/hyperresearch-cloud-api.md) · [All operations](https://skmtc.dev/hyperresearch/apis/hyperresearch-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hyperresearch/apis/hyperresearch-cloud-api/revisions/726ef831ebf4?raw)