Skip to main content
Use this endpoint to fetch a specific clinical note by its unique ID. The response includes the full note body, metadata, and all associated identifiers such as patientId, authorId, and encounterId.

Request

GET https://api.clinikapi.com/v1/notes/:id

Headers

x-api-key
string
required
Your ClinikAPI secret key (clk_live_* or clk_test_*).

Path parameters

id
string
required
The ID of the note to retrieve (e.g. note_abc123).

Response

Returns 200 OK with the note wrapped in the standard envelope.
data.id
string
Note ID.
data.patientId
string
ID of the patient this note belongs to.
data.authorId
string
ID of the practitioner who authored the note.
data.encounterId
string
ID of the encounter associated with this note.
data.type
string
Note type (e.g. progress-note, discharge-summary).
data.title
string
Note title.
data.content
string
Full note body content.
data.contentType
string
MIME type of the content (e.g. text/plain, text/markdown).
data.docStatus
string
Document status: preliminary, final, or amended.
data.category
string
Category tag, if set.
data.date
string
Clinically relevant date in YYYY-MM-DD format.
meta
object
Standard response metadata including requestId, timestamp, status, and rate-limit fields.

Examples

curl

curl https://api.clinikapi.com/v1/notes/note_abc123 \
  -H "x-api-key: clk_live_abc123"

TypeScript SDK

import { Clinik } from '@clinikapi/sdk';

const clinik = new Clinik(process.env.CLINIKAPI_SECRET_KEY!);

const { data: note } = await clinik.notes.read('note_abc123');

console.log(note.title);     // "Follow-up Visit - Hypertension Management"
console.log(note.docStatus); // "final"