---
title: "List notebooks"
method: GET
path: "/notes/~/v1/notebooks"
---

# List notebooks

`GET /notes/~/v1/notebooks`

All notebooks the authenticated identity can view (hosted or
subscribed). Same data as the `/x/v0/notebooks` scry, but
honors `X-Api-Key` so a bot can read without a session cookie.

## Response `200`

Notebook summaries

- NotebookSummary[]
  - `host` string, required
  - `flagName` string, required
  - `notebook` Notebook, required
    - `id` integer, required
    - `title` string, required
    - `rootFolderId` integer, required — Id of the notebook's root folder. Pass this as `parent` when creating a folder/note at the top level. Equal to `id + 1`.
    - `createdBy` string, required
    - `createdAt` integer, required — Unix seconds
    - `updatedAt` integer, required
    - `updatedBy` string, required
  - `visibility` 'public' | 'private', required

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/tloncorp/apis/notes-v1-http-api.md) · [All operations](https://skmtc.dev/tloncorp/apis/notes-v1-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tloncorp/notes-v1-http-api/revisions/9beef8e14823/schema)