patient-demographics-summary

Patient Demographics Summary

Overview

Pull structured demographic data from FHIR Patient, RelatedPerson, and Coverage resources. Format into a consolidated summary including identifiers, contact information, emergency contacts, insurance, preferred language, communication preferences, and advance directive status. Flag missing critical data elements that may affect care delivery.

FHIR Resources Used

Resource	Purpose	Key Fields
Patient	Core demographics	name, birthDate, gender, address, telecom, communication, identifier, extension
RelatedPerson	Emergency contacts, guarantors	name, telecom, relationship, period
Coverage	Insurance information	status, type, subscriberId, payor, period, class

Instructions

Step 1: Retrieve Patient Resource

Tool: fhir_read
resourceType: "Patient"
id: "[patient-id]"

Extract the following fields:

• Identifiers: MRN (identifier where type.coding.code = "MR"), SSN (last 4 only), driver's license
• Name: name array -- use name.use = "official" as primary; note maiden names (use = "maiden")
• Birth Date: birthDate (calculate age)
• Gender: gender (administrative gender)
• Race/Ethnicity: US Core extensions at extension where URL = http://hl7.org/fhir/us/core/StructureDefinition/us-core-race and http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity
• Address: address array -- identify use = "home" vs "work" vs "temp"
• Telecom: telecom array -- phone (system = "phone"), email (system = "email"), fax
• Preferred Language: communication array where preferred = true
• Marital Status: maritalStatus
• Deceased: deceasedBoolean or deceasedDateTime
• Managing Organization: managingOrganization

Step 2: Retrieve Emergency Contacts and Related Persons

Tool: fhir_search
resourceType: "RelatedPerson"
queryParams: "patient=[patient-id]"

For each RelatedPerson:

• Extract name, relationship type (relationship.coding.code), phone, email
• Check period to confirm the relationship is current (no end date or end > today)
• Identify relationship roles: emergency contact, next of kin, guarantor, power of attorney