Notes

Get note

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.

get/v1/notes/{id}

Request

  • Base URL
    https://api.blinq.me
  • Auth
    HTTP bearer

Path parameters

idstring required

The note ID.

Response

The requested note.

idstring required

The ID of the note.

titlestring nullable required

The custom title set by the user, otherwise the generated title, or null when the note has neither.

created_atstring date-time required

When the user's device created the note, as an ISO 8601 timestamp.

updated_atstring date-time required

When the note was last updated, as an ISO 8601 timestamp.

deleted_atunknown 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_urlstring 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.

contentstring 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_formatunknown 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.

Changes

No recorded changes to this operation across all 1 revision of this API.