---
title: "Get note"
method: GET
path: "/v1/notes/{id}"
tags: ["Notes"]
---

# Get note

`GET /v1/notes/{id}`

## Request

- Base URL: `https://api.blinq.me`
- URL: `https://api.blinq.me/v1/notes/{id}`
- Auth: HTTP bearer

Gets a note owned by the authenticated user, including its content or AI summary when available.

Missing notes and notes owned by another user both return `404`.

Requires the `blinq:notes:read` scope.

## Path parameters

- `id` string, required

## Response `200`

The requested note.

- object: The requested note.
  - `id` string, required: The ID of the note.
  - `title` string, nullable, required: The custom title set by the user, otherwise the generated title, or `null` when the note has neither.
  - `created_at` string, date-time, required: When the user's device created the note, as an ISO 8601 timestamp.
  - `updated_at` string, date-time, required: When the note was last updated, as an ISO 8601 timestamp.
  - `deleted_at` unknown, required
  - `status` 'processing' | 'ready' | 'failed' | 'blocked', required: The processing state of the note. `processing`: recording or processing is in progress. `ready`: no recording or processing is pending. Content may be empty or null. `failed`: processing failed. Partial content may be available. `blocked`: processing is blocked by the account plan or usage limits.
  - `type` 'voice_note' | 'phone_call' | 'text', nullable, required: How the note was captured: a recorded `voice_note`, a recorded `phone_call`, or a typed `text` note. `null` when the type is unavailable.
  - `share_url` string, nullable, required: A URL for viewing the note in a browser, or `null` when the note has no share link. Reading a note never creates a share link or changes sharing settings.
  - `linked_contacts` object[], required: The contacts linked to the note, or an empty array when there are none. Retrieving a linked contact requires `blinq:contacts:read` and contact access.
    - `id` string, required: The ID of the linked contact.
    - `full_name` string, nullable, required: The display name of the linked contact, or `null` when none is available.
    - `workspace_id` string, required: The personal workspace ID to pass when getting this contact.
  - `content` string, nullable, required: The stored body: an AI summary for a recording or saved text for a text note. `null` means no body is stored; an empty stored body remains `""`. Use `status` to determine processing state.
  - `content_format` unknown, required
  - `source` 'mobile' | 'watch' | 'device', nullable, required: The device type that recorded the note: a `mobile` phone, a `watch`, or the Blinq notetaker `device`. `null` when unknown.

## Other responses

- `400`: Bad request - Invalid query parameters or body. See `details` for each failing field
- `401`: Unauthorized - Missing or invalid API key
- `403`: Forbidden - Missing scope, insufficient permission, or the plan does not include this operation
- `404`: Not found - The note does not exist or belongs to another user

---

[API](https://skmtc.dev/blinq/apis/blinq-public-api.md) - [All operations](https://skmtc.dev/blinq/apis/blinq-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blinq/apis/blinq-public-api/revisions/2dedf4b14340?raw)