---
title: "GET /api/notebooks"
method: GET
path: "/api/notebooks"
tags: ["notebook-controller"]
---

# GET /api/notebooks

`GET /api/notebooks`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/notebooks`
- Auth: none declared

## Response `200`

OK

- NotebooksViewedByUser
  - `notebooks` NotebookRealm[], required
    - `notebook` Notebook, required
      - `id` integer, required
      - `notebookSettings` NotebookSettings, required
        - `skipMemoryTrackingEntirely` boolean
      - `creatorId` string
      - `name` string, required
      - `circle` Circle
        - `id` integer, required
        - `name` string, required
      - `description` string
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `readmeContent` string
    - `hasAttachedBook` boolean
    - `readonly` boolean
    - `readmeContent` string: Container-owned notebook readme markdown. Omitted when absent.
  - `catalogItems` union[], required
    - union
      - NotebookCatalogGroupItem
        - `type` string, required
        - `id` integer, required
        - `name` string, required
        - `createdAt` string, date-time, required
        - `notebooks` NotebookRealm[], required
          - `notebook` Notebook, required
            - `id` integer, required
            - `notebookSettings` NotebookSettings, required
              - …
            - `creatorId` string
            - `name` string, required
            - `circle` Circle
              - …
            - `description` string
            - `createdAt` string, date-time, required
            - `updatedAt` string, date-time, required
            - `readmeContent` string
          - `hasAttachedBook` boolean
          - `readonly` boolean
          - `readmeContent` string: Container-owned notebook readme markdown. Omitted when absent.
      - NotebookCatalogNotebookItem
        - `type` string, required
        - `notebook` Notebook, required
          - `id` integer, required
          - `notebookSettings` NotebookSettings, required
            - `skipMemoryTrackingEntirely` boolean
          - `creatorId` string
          - `name` string, required
          - `circle` Circle
            - `id` integer, required
            - `name` string, required
          - `description` string
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `readmeContent` string
        - `hasAttachedBook` boolean
      - NotebookCatalogSubscribedNotebookItem
        - `type` string, required
        - `notebook` Notebook, required
          - `id` integer, required
          - `notebookSettings` NotebookSettings, required
            - `skipMemoryTrackingEntirely` boolean
          - `creatorId` string
          - `name` string, required
          - `circle` Circle
            - `id` integer, required
            - `name` string, required
          - `description` string
          - `createdAt` string, date-time, required
          - `updatedAt` string, date-time, required
          - `readmeContent` string
        - `subscriptionId` integer, required
        - `hasAttachedBook` boolean
  - `subscriptions` SubscriptionForNotebooksListing[]
    - `id` integer, required
    - `dailyTargetOfNewNotes` integer, required
    - `user` User
      - `id` integer, required
      - `name` string, required
      - `externalIdentifier` string, required
      - `ownership` Ownership
        - `id` integer
        - `circle` Circle
          - `id` integer, required
          - `name` string, required
        - `ownerName` string
      - `dailyAssimilationCount` integer
      - `healthRemoveEmptyFoldersDefault` boolean
      - `dailyProbeEnabled` boolean
      - `admin` boolean
    - `notebook` Notebook, required
      - `id` integer, required
      - `notebookSettings` NotebookSettings, required
        - `skipMemoryTrackingEntirely` boolean
      - `creatorId` string
      - `name` string, required
      - `circle` Circle
        - `id` integer, required
        - `name` string, required
      - `description` string
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `readmeContent` string
    - `hasAttachedBook` boolean
    - `name` string

## Changes

- **2026-08-29** `a5d579a70625`: 1 info
  - added the optional property `subscriptions/items/user/dailyProbeEnabled` to the response with the `200` status
- **2026-08-15** `cacb660db3de`: 1 warning
  - removed the optional property `subscriptions/items/user/spaceIntervals` from the response with the `200` status
- **2026-07-22** `2efef999b669`: 1 info
  - added the optional property `subscriptions/items/user/healthRemoveEmptyFoldersDefault` to the response with the `200` status
- **2026-07-22** `13f77438750e`: 7 warning, 7 info
  - removed the optional property `catalogItems/items/oneOf[#/components/schemas/NotebookCatalogGroupItem]/allOf[subschema #2]/notebooks/items/indexContent` from the response with the `200` status
  - removed the optional property `catalogItems/items/oneOf[#/components/schemas/NotebookCatalogGroupItem]/allOf[subschema #2]/notebooks/items/notebook/indexContent` from the response with the `200` status
  - removed the optional property `catalogItems/items/oneOf[#/components/schemas/NotebookCatalogNotebookItem]/allOf[subschema #2]/notebook/indexContent` from the response with the `200` status
  - removed the optional property `catalogItems/items/oneOf[#/components/schemas/NotebookCatalogSubscribedNotebookItem]/allOf[subschema #2]/notebook/indexContent` from the response with the `200` status
  - …10 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/changes/api/notebooks/get.md)

---

[API](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api.md) - [All operations](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nerds-odd-e/apis/odd-e-open-api/revisions/f78415aa9270?raw)