Skip to main content
Assessments map to the FHIR R4 ClinicalImpression resource — a structured record of a clinician’s overall evaluation of a patient at a point in time. An assessment captures coded findings (ICD-10, SNOMED), a narrative summary, and a clinical note. Assessments complement progress notes: notes are narrative, assessments are structured.

​
Create an assessment

const { data: assessment } = await clinik.assessments.create({
  status: 'completed',
  patientId: 'pt_abc123',
  encounterId: 'enc_xyz789',
  practitionerId: 'prac_def456',
  description: 'Annual wellness assessment',
  summary:
    'Patient presents with well-controlled hypertension and type 2 diabetes. '
    + 'No signs of end-organ damage. Continue current medication regimen. '
    + 'Recommend dietary counseling and increased physical activity.',
  findings: [
    { code: 'I10', text: 'Essential hypertension — well controlled on lisinopril 10mg' },
    { code: 'E11.9', text: 'Type 2 diabetes mellitus — HbA1c 6.8%, at goal' },
    { text: 'BMI 28.5 — overweight, recommend weight management' },
    { text: 'No peripheral neuropathy on exam' },
  ],
  note: 'Follow up in 3 months. Order HbA1c and CMP at next visit.',
  effectiveDateTime: '2025-01-15T10:00:00Z',
});

​
Findings

Findings can include coded diagnoses (ICD-10, SNOMED CT) and free-text descriptions. You can mix coded and uncoded findings in the same assessment: 
findings: [
  // ICD-10 coded finding
  { code: 'I10', text: 'Essential hypertension' },
  // Free-text only
  { text: 'Patient reports improved energy levels' },
  // SNOMED CT coded
  { code: '44054006', text: 'Type 2 diabetes mellitus' },
]

​
Status values

StatusDescription
in-progressAssessment is being conducted
completedAssessment is finalized

​
Read an assessment

const { data: assessment } = await clinik.assessments.read('assess_abc123');

​
Update an assessment

await clinik.assessments.update('assess_abc123', {
  status: 'completed',
  summary: 'Updated summary with additional findings...',
  findings: [
    { code: 'I10', text: 'Essential hypertension — well controlled' },
    { code: 'E11.9', text: 'Type 2 diabetes — at goal' },
    { text: 'New finding: mild vitamin D deficiency' },
  ],
  note: 'Added vitamin D supplementation to plan.',
});

​
Delete an assessment

await clinik.assessments.delete('assess_abc123');

​
Search assessments

// All completed assessments for a patient
const { data } = await clinik.assessments.search({
  patientId: 'pt_abc123',
  status: 'completed',
  sort: '-date',
});

// Assessments by a specific practitioner
const { data: byDoc } = await clinik.assessments.search({
  practitionerId: 'prac_def456',
  dateFrom: '2025-01-01',
});

​
Assessments vs notes

ResourcePurpose
Assessment (ClinicalImpression)Structured clinical evaluation with coded findings
Note (DocumentReference)Narrative documentation — SOAP notes, discharge summaries
Use assessments when you need coded, queryable findings that can feed into reporting or clinical decision support. Use Notes for free-form narrative. An encounter will often have both: a progress note for the SOAP narrative and an assessment for the structured diagnoses.