Skip to main content

clinik.riskAssessments

Risk assessments (FHIR RiskAssessment) capture the results of clinical risk evaluations — cardiovascular risk scores, fall risk assessments, cancer screening results, and other predictive analyses.

create

const { data, meta } = await clinik.riskAssessments.create(request): Promise<ApiResponse<RiskAssessment>>
FieldTypeRequiredDescription
statusstringYesregistered, preliminary, final, amended
patientIdstringYesPatient reference
encounterIdstringNoEncounter context
methodstringNoAssessment method
codestringNoAssessment code
occurrenceDateTimestringNoWhen the assessment occurred
conditionIdstringNoCondition being assessed
performerIdstringNoPerforming practitioner ID
reasonCodestring[]NoReason codes
predictionArray<object>NoRisk predictions
mitigationstringNoMitigation actions
notestringNoAdditional notes
basedOnIdstringNoBased on reference

prediction

FieldTypeDescription
outcomestringPredicted outcome
probabilityDecimalnumberProbability (0-1)
qualitativeRiskstringQualitative risk level
relativeRisknumberRelative risk ratio
rationalestringExplanation of the prediction

Example

const { data } = await clinik.riskAssessments.create({
  status: 'final',
  patientId: 'pt_abc123',
  performerId: 'prac_def456',
  method: 'Framingham Risk Score',
  code: 'cardiovascular-risk',
  conditionId: 'cond_hypertension',
  prediction: [
    {
      outcome: 'Myocardial infarction',
      probabilityDecimal: 0.12,
      qualitativeRisk: 'moderate',
      rationale: '10-year ASCVD risk based on age, cholesterol, blood pressure, smoking status',
    },
    {
      outcome: 'Stroke',
      probabilityDecimal: 0.08,
      qualitativeRisk: 'low',
      rationale: 'Based on CHA2DS2-VASc score of 2',
    },
  ],
  mitigation: 'Start statin therapy. Lifestyle modifications: diet, exercise, smoking cessation.',
  reasonCode: ['Hypertension', 'Hyperlipidemia', 'Family history of CAD'],
});
Same pattern as other resources. Search supports patientId, status, method, conditionId filters.