Family History

The Family History feature allows the user to record or update the patient's family history SNOMED-CT problems. The Family History Changed Subscription feature will allow the user to retrieve changes to the family history data. For more information about subscriptions, please refer Changed Data Subscriptions.

FAMILY
The beta practice setting 'Family History Reconciliation Update' must be turned on.  

Make sure you support multiple relations of the same type having the same issue (two brothers both having high blood pressure), and a single person having an issue more than once (the mother having two instances of cancer). The family history section is structured differently than other sections. Other sections have question fields that contain a list of single question/answer pairs with some metadata. For the family history section, each of those question/answer entries is itself an array of data, one sub-entry per relation or per occurence. The relations do not specify biological vs logical (step/adoptive/etc.) relations. Biological relations are assumed. In general, practices only track relations that have problems, although they can be configured to have an Alive and Well status. 

• 'snomedfamilyhistoryproblemid' ties it to the practice-specific family history element and can be used to tie the same question across multiple forms. 
• 'snomedcode' is the SNOMED code value for this particular problem. 
• 'text' is the patient-friendly name of the problem. 
• 'origtext' is the SNOMED term for this problem, which almost always matches text. We recommend you use text and not origtext. 
• 'fields' contains a list of problem instances, each of which contains: 
• 'default' is the Y/N checkbox that indicates whether this person has this problem. 
• 'relation' is the relation this person has with the patient (mother, sister, etc.). 
• 'relationkeyid' is the ID of the particular relation. Each relation type has its own keyspace. This means you can have a Brother 1, Brother 2, Sister 1, etc. 
• 'onsetage' is the age when the problem started. 
• 'diedofage' is the age when the relation died from this particular problem. 

'relationkeyid' is a REQUIRED field. 
If you add a new relation, specify the next available numerical value for relationkeyid. It’s possible to receive a missing/null relationkeyid. This is always from the portal. Until that is fixed, assign the next available relationkeyid to that empty value. We do not cross check between entries. This  means a particular relative could be specified to have died at two different ages from two different problems. We match on problem/relation/relationkeyid/onsetage. This means that a given person (e.g., Brother 2) can have two instances of the same problem (e.g., two instances of cancer).

Was this information helpful? Yes | No What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Get patient's family history
GET
/v1/{practiceid}/chart/{patientid}/familyhistory

Retrieves the family history for a specific patient

Was this information helpful? Yes | No What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Try in Postman

Input Parameters

Expand all
Example Code
Update patient's family history
Get list of family history change events to which you can subscribe
GET
/v1/{practiceid}/chart/healthhistory/familyhistory/changed/subscription/events

Retrieve the list of events that can be input for this subscription

Was this information helpful? Yes | No What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Try in Postman

Input Parameters

Expand all
Example Code
Subscribe to all/specific change events for family history
POST
/v1/{practiceid}/chart/healthhistory/familyhistory/changed/subscription

Subscribes for changed familyhistory events

Was this information helpful? Yes | No What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Try in Postman

Input Parameters

Expand all
Example Code
Get list of family history change subscription(s)
GET
/v1/{practiceid}/chart/healthhistory/familyhistory/changed/subscription

Retrieves list of events applicable for family history

Was this information helpful? Yes | No What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Try in Postman

Input Parameters

Expand all
Example Code
Get list of changes in family history based on subscribed events
Example Code
Unsubscribe to all/specific change events for family history
DELETE
/v1/{practiceid}/chart/healthhistory/familyhistory/changed/subscription

Delete an specific event which is no longer required

Was this information helpful? Yes | No What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Try in Postman

Input Parameters

Expand all
Example Code