---
title: "GET /api/circles/{circle}"
method: GET
path: "/api/circles/{circle}"
tags: ["circle-controller"]
---

# GET /api/circles/{circle}

`GET /api/circles/{circle}`

## Request

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

## Path parameters

- `circle` integer, required

## Response `200`

OK

- CircleForUserView
  - `id` integer, required
  - `name` string, required
  - `invitationCode` string, required
  - `notebooks` NotebooksViewedByUser, required
    - `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
              - …
            - `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
              - …
            - `creatorId` string
            - `name` string, required
            - `circle` Circle
              - …
            - `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
              - …
            - `creatorId` string
            - `name` string, required
            - `circle` Circle
              - …
            - `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
  - `members` UserForOtherUserView[], required
    - `name` string

## Changes

- **2026-08-29** `a5d579a70625`: 1 info
  - added the optional property `notebooks/subscriptions/items/user/dailyProbeEnabled` to the response with the `200` status
- **2026-08-15** `cacb660db3de`: 1 warning
  - removed the optional property `notebooks/subscriptions/items/user/spaceIntervals` from the response with the `200` status
- **2026-07-22** `2efef999b669`: 1 info
  - added the optional property `notebooks/subscriptions/items/user/healthRemoveEmptyFoldersDefault` to the response with the `200` status
- **2026-07-22** `13f77438750e`: 7 warning, 7 info
  - removed the optional property `notebooks/catalogItems/items/oneOf[#/components/schemas/NotebookCatalogGroupItem]/allOf[subschema #2]/notebooks/items/indexContent` from the response with the `200` status
  - removed the optional property `notebooks/catalogItems/items/oneOf[#/components/schemas/NotebookCatalogGroupItem]/allOf[subschema #2]/notebooks/items/notebook/indexContent` from the response with the `200` status
  - removed the optional property `notebooks/catalogItems/items/oneOf[#/components/schemas/NotebookCatalogNotebookItem]/allOf[subschema #2]/notebook/indexContent` from the response with the `200` status
  - removed the optional property `notebooks/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/circles/:circle/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/193c5e89085a?raw)