CDA Examples
1.0.0 - active United States of America flag

CDA Examples, published by Health Level Seven. This guide is not an authorized publication; it is the continuous build for version 1.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/CDA-Examples/ and changes regularly. See the Directory of published versions

Example: Patient Demographic Information

Approval Status: Approved
Task Force Approval: 2015-09-24
SDWG Approval: 2015-10-15, 2017-02-02

This example illustrates how to structure Patient Demographics for the 170.314(b)(2) Transitions of care - A) Patient Demographics.


<recordTarget xmlns="urn:hl7-org:v3">
  <patientRole>
    <!--  The @root OID below (which is fictional) would be specific to an institution's record identifier system.  -->
    <id root="2.16.840.1.113883.3.6132" extension="345678912-0154"/>
    <!--  HP is "primary home" from valueSet 2.16.840.1.113883.1.11.10637  -->
    <addr use="HP">
      <!--  You can have multiple [1..4] streetAddressLine elements. Single shown below  -->
      <streetAddressLine>1436 Jennyhill Ln.</streetAddressLine>
      <city>Hollywood</city>
      <!--  5 or 9 digit zip codes from valueSet 2.16.840.1.113883.3.88.12.80.2 -->
      <!--  PostalCode is required if the country is US. If country is not specified, it's assumed to be US. If country  -->
      <!--  is something other than US, the postalCode MAY be present but MAY be bound to different vocabularies  -->
      <postalCode>90068</postalCode>
      <!--  State is required if the country is US. If country is not specified, it's assumed to be US.  -->
      <!--  If country is something other than US, the state MAY be present but MAY be bound to different vocabularies  -->
      <!--  OR is "Oregon" from valueSet 2.16.840.1.113883.3.88.12.80.1  -->
      <state>CA</state>
      <!--  US is the two digit code for "United States"  -->
      <country>US</country>
    </addr>
    <!--  MC is "mobile contact" from HL7 AddressUse 2.16.840.1.113883.5.1119  -->
    <telecom value="tel:+1(565)867-5309" use="MC"/>
    <!--  Multiple telecoms are possible  -->
    <telecom value="mailto:adam@diameterhealth.com" use="WP"/>
    <patient>
      <name use="L">
        <given>Adam</given>
        <family>Everyman</family>
      </name>
      <!--  From CDA R2 on administrativeGender Code: This attribute does not include terms related to clinical gender.
           Gender is a complex physiological, genetic and sociological concept that requires multiple observations in order to be
           comprehensively described. The purpose of this attribute is to provide a high level classification that can additionally
           be used for the appropriate allocation of inpatient bed assignment. -->
      <!--  Sex at birth and gender identity may be specified in social history  -->
      <administrativeGenderCode displayName="Male"
                                codeSystemName="AdministrativeGender" codeSystem="2.16.840.1.113883.5.1" code="M"/>
      <birthTime value="19621022"/>
      <maritalStatusCode displayName="Married"
                         codeSystemName="MaritalStatus" codeSystem="2.16.840.1.113883.5.2" code="M"/>
      <religiousAffiliationCode
                                displayName="Christian (non-Catholic, non-specific)" codeSystemName="HL7 Religious Affiliation"
                                codeSystem="2.16.840.1.113883.5.1076" code="1013"/>
      <!--  CDC Race and Ethnicity code set contains the five minimum race and ethnicity categories defined by OMB Standards  -->
      <raceCode displayName="White" codeSystemName="CDC Race and Ethnicity"
                codeSystem="2.16.840.1.113883.6.238" code="2106-3"/>
      <ethnicGroupCode displayName="Not Hispanic or Latino"
                       codeSystemName="CDC Race and Ethnicity" codeSystem="2.16.840.1.113883.6.238" code="2186-5"/>
      <languageCommunication>
        <languageCode code="en"/>
        <!--  "en" is ISO 639-1 alpha-2 code for "English"  -->
        <modeCode displayName="Expressed spoken"
                  codeSystemName="LanguageAbilityMode" codeSystem="2.16.840.1.113883.5.60" code="ESP"/>
        <proficiencyLevelCode displayName="Excellent"
                              codeSystemName="LanguageAbilityProficiency" codeSystem="2.16.840.1.113883.5.61" code="E"/>
        <preferenceInd value="true"/>
      </languageCommunication>
      <!--  Multiple languages are permitted. Only one should have a preferenceInd = true  -->
      <languageCommunication>
        <languageCode code="it"/>
        <modeCode displayName="Expressed spoken"
                  codeSystemName="LanguageAbilityMode" codeSystem="2.16.840.1.113883.5.60" code="ESP"/>
        <proficiencyLevelCode displayName="Good"
                              codeSystemName="LanguageAbilityProficiency" codeSystem="2.16.840.1.113883.5.61" code="G"/>
        <!--  Patient's preferred language  -->
        <preferenceInd value="false"/>
      </languageCommunication>
    </patient>
  </patientRole>
</recordTarget>