Skip to main content

Conditions

Conditions (FHIR Condition) represent clinical diagnoses, problems, and health concerns. They support the problem list, encounter diagnoses, staging, and evidence tracking throughout the condition lifecycle.

Record a Diagnosis

const { data: condition } = await clinik.conditions.create({
  patientId: 'pt_abc123',
  clinicalStatus: 'active',
  verificationStatus: 'confirmed',
  category: ['encounter-diagnosis'],
  severity: 'moderate',
  code: {
    system: 'http://hl7.org/fhir/sid/icd-10-cm',
    code: 'E11.9',
    display: 'Type 2 diabetes mellitus without complications',
  },
  encounterId: 'enc_visit456',
  onsetDateTime: '2023-08-15',
  recordedDate: '2024-01-10',
  recorderId: 'pract_dr456',
  note: 'Patient presents with elevated HbA1c of 7.8%. Starting metformin.',
});

Problem List Entry

const { data: problem } = await clinik.conditions.create({
  patientId: 'pt_abc123',
  clinicalStatus: 'active',
  verificationStatus: 'confirmed',
  category: ['problem-list-item'],
  code: {
    system: 'http://snomed.info/sct',
    code: '38341003',
    display: 'Hypertension',
  },
  onsetString: 'Diagnosed in 2020',
  stage: [
    { summary: 'Stage 2', type: 'clinical' },
  ],
  evidence: [
    { code: ['Elevated blood pressure readings'] },
  ],
});

Condition with Staging and Evidence

const { data: cancer } = await clinik.conditions.create({
  patientId: 'pt_abc123',
  clinicalStatus: 'active',
  verificationStatus: 'confirmed',
  category: ['problem-list-item'],
  severity: 'severe',
  code: {
    system: 'http://snomed.info/sct',
    code: '254837009',
    display: 'Malignant neoplasm of breast',
  },
  bodySite: ['Left breast'],
  onsetDateTime: '2024-02-01',
  recordedDate: '2024-02-15',
  stage: [
    { summary: 'Stage IIA', type: 'pathological' },
  ],
  evidence: [
    { code: ['Mammography findings', 'Biopsy results'] },
    { detailIds: ['obs_mammo123', 'obs_biopsy456'] },
  ],
});

Mark a Condition as Resolved

await clinik.conditions.update(condition.id, {
  clinicalStatus: 'resolved',
  abatementDateTime: '2024-06-01',
  note: 'HbA1c normalized. Condition resolved with lifestyle changes.',
});

Search Conditions

// Active conditions for a patient
const { data } = await clinik.conditions.search({
  patientId: 'pt_abc123',
  clinicalStatus: 'active',
});

// Problem list items
const { data: problems } = await clinik.conditions.search({
  patientId: 'pt_abc123',
  category: 'problem-list-item',
});

// Search by ICD-10 code
const { data: diabetes } = await clinik.conditions.search({
  code: 'E11.9',
});

Clinical Status Lifecycle

StatusDescription
activeCondition is currently active
recurrenceCondition has recurred after resolution
relapseCondition has relapsed after remission
inactiveCondition is no longer active
remissionCondition is in remission
resolvedCondition is fully resolved