Skip to main content
Use this endpoint to fetch a specific clinical assessment by its unique ID. The response includes the full assessment record — status, summary, all coded and free-text findings, and the associated patient, practitioner, and encounter identifiers.

​
Request

GET https://api.clinikapi.com/v1/assessments/: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 assessment to retrieve (e.g. assess_abc123).

​
Response

Returns 200 OK with the assessment wrapped in the standard envelope.
​
data.id
string
Assessment ID.
​
data.patientId
string
ID of the patient this assessment belongs to.
​
data.practitionerId
string
ID of the practitioner who conducted the assessment.
​
data.encounterId
string
ID of the encounter this assessment is associated with.
​
data.status
string
Assessment status: in-progress or completed.
​
data.description
string
Short description of the assessment context.
​
data.summary
string
Narrative clinical summary.
​
data.findings
array
Array of finding objects, each with optional code and text.
​
data.note
string
Additional clinician notes, if provided.
​
data.effectiveDateTime
string
ISO 8601 timestamp of when the assessment was conducted.
​
meta
object
Standard response metadata including requestId, timestamp, status, and rate-limit fields.

​
Examples

​
curl

curl https://api.clinikapi.com/v1/assessments/assess_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: assessment } = await clinik.assessments.read('assess_abc123');

console.log(assessment.status);  // "completed"
console.log(assessment.summary); // "Patient presents with well-controlled hypertension..."