Skip to main content

clinik.familyHistory

Family member history records significant health conditions for a person related to the patient, relevant in the context of care (e.g., genetic risk factors, hereditary conditions).

create

const { data, meta } = await clinik.familyHistory.create(request): Promise<ApiResponse<FamilyMemberHistory>>
FieldTypeRequiredDescription
statusstringYespartial, completed, health-unknown
patientIdstringYesPatient this history belongs to
datestringNoWhen the history was recorded
namestringNoFamily member’s name
relationshipstringYesRelationship to patient (mother, father, sibling, etc.)
sexstringNoFamily member’s sex
bornDatestringNoFamily member’s birth date
ageStringstringNoApproximate age (e.g. “around 50”)
estimatedAgebooleanNoWhether the age is estimated
deceasedBooleanbooleanNoWhether the family member is deceased
deceasedDatestringNoDate of death
reasonCodestring[]NoWhy the history was recorded
notestringNoAdditional notes
conditionArrayNoHealth conditions (code, outcome, contributedToDeath, onsetString, note)

Example

const { data } = await clinik.familyHistory.create({
  status: 'completed',
  patientId: 'pt_jane_doe',
  date: '2025-01-15',
  name: 'Robert Doe',
  relationship: 'father',
  sex: 'male',
  deceasedBoolean: true,
  deceasedDate: '2020-06-10',
  condition: [
    {
      code: 'Type 2 Diabetes Mellitus',
      onsetString: 'Age 45',
      note: 'Managed with metformin',
    },
    {
      code: 'Coronary Artery Disease',
      contributedToDeath: true,
      onsetString: 'Age 60',
      outcome: 'Fatal myocardial infarction',
    },
  ],
  note: 'Father had significant cardiovascular risk factors',
});
Same pattern as other resources. Search supports patientId, status, relationship, dateFrom, dateTo filters.