---
title: "Get collection notes"
method: GET
path: "/api/v1/collections/{collectionH}/notes"
tags: ["Collections"]
---

# Get collection notes

`GET /api/v1/collections/{collectionH}/notes`

## Request

- Base URL: `https://numonic.ai`
- URL: `https://numonic.ai/api/v1/collections/{collectionH}/notes`
- Auth: API key in header `x-api-key`

Retrieve all notes attached to a collection.

## Path parameters

- `collectionH` string, required: Collection hash (40-char hex SHA-1)

## Response `200`

Notes retrieved

- NotesListResponse
  - `notes` NoteItem[], required
    - `annotation_id` string, required
    - `annotation_link` string, required
    - `content` string, required
    - `content_type` 'text' | 'markdown' | 'visual', required
    - `visibility` 'private' | 'team' | 'public', required
    - `status` 'active' | 'deleted', required
    - `created_at` string, required
    - `superseded_at` string, nullable
    - `superseded_by` string, nullable
    - `parent_annotation_id` string, nullable
    - `reply_count` integer, required
    - `depth` integer, required: 0 = top-level, 1 = reply, 2 = reply-to-reply
    - `spatial_data` object, nullable
      - `pin_x` number, required
      - `pin_y` number, required
      - `canvas_width` number
      - `canvas_height` number
      - `frame_number` number
    - `author` NoteAuthor, required
      - `agent_id` string, required
      - `display_name` string, required
      - `agent_type` 'Human' | 'AI_Assistant' | 'System' | 'Integration'
  - `total_count` integer, required

## Other responses

- `404`: Collection not found

---

[API](https://skmtc.dev/numonic/apis/numonic-api.md) · [All operations](https://skmtc.dev/numonic/apis/numonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/numonic/apis/numonic-api/revisions/6c559bef1e35?raw)