---
title: "List notes"
method: GET
path: "/sessions/{session_id}/notes"
tags: ["notes"]
---

# List notes

`GET /sessions/{session_id}/notes`

## Request

- Base URL: `https://api.helena.bio` (the document declares no server; this is the origin it was published from)
- URL: `https://api.helena.bio/sessions/{session_id}/notes`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/helena-bioinformatics/apis/helix-insight-variant-analysis-service/docs/sessions/:session_id/notes/get.ts> (a function with typed inputs; its response is checked against the schema)

List notes for a case, optionally filtered by variant.

## Path parameters

- `session_id` string, uuid, required

## Query parameters

- `variant_idx` integer, nullable: Filter by variant index

## Response `200`

Successful Response

- NotesListResponse: Response for listing notes.
  - `notes` NoteResponse[], required
    - `id` string, uuid, required
    - `user` NoteAuthor, required: Compact author info for display.
      - `name` string, required
      - `initials` string, required
    - `variant_idx` integer, nullable, required
    - `text` string, required
    - `created_at` string, date-time, required
  - `total_count` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/helena-bioinformatics/apis/helix-insight-variant-analysis-service.md) - [All operations](https://skmtc.dev/helena-bioinformatics/apis/helix-insight-variant-analysis-service/llms.txt) - [OpenAPI document](https://skmtc.dev/helena-bioinformatics/apis/helix-insight-variant-analysis-service/revisions/a800b0b27feb?raw)