Appearance

CDA RecordTarget Structure ​

This example includes identifiers, demographics, address, and telecom information, conforming to CDA Release 2 and aligned with US Realm header constraints (like those in C-CDA).

<recordTarget>

<patientRole>

<!-- Patient Identifier (e.g., MRN issued by the hospital) -->

<id root="2.16.840.1.113883.19.5" extension="123456"/>

<!-- Address -->

<addr use="HP">

<streetAddressLine>123 Main Street</streetAddressLine>

<city>Metropolis</city>

<state>NY</state>

<postalCode>10001</postalCode>

<country>US</country>

</addr>

<!-- Telecom (Home and Mobile) -->

<telecom use="HP" value="tel:+1-555-123-4567"/>

<telecom use="MC" value="tel:+1-555-987-6543"/>

<!-- Patient Element -->

<patient>

<!-- Name -->

<name use="L">

<given>John</given>

<given qualifier="CL">Alexander</given>

<family>Doe</family>

<suffix>III</suffix>

<prefix>Mr.</prefix>

</name>

<!-- Administrative Gender Code -->

<administrativeGenderCode code="M" codeSystem="2.16.840.1.113883.5.1" displayName="Male"/>

<!-- Birth Time -->

<birthTime value="19800101"/>

<!-- Marital Status -->

<maritalStatusCode code="M" codeSystem="2.16.840.1.113883.5.2" displayName="Married"/>

<!-- Religious Affiliation (optional) -->

<religiousAffiliationCode code="1013" codeSystem="2.16.840.1.113883.5.1076" displayName="Christianity"/>

<!-- Race Code -->

<raceCode code="2106-3" codeSystem="2.16.840.1.113883.6.238" displayName="White"/>

<!-- Ethnic Group Code -->

<ethnicGroupCode code="2186-5" codeSystem="2.16.840.1.113883.6.238" displayName="Not Hispanic or Latino"/>

<!-- Language Communication -->

<languageCommunication>

<languageCode code="en-US"/>

<modeCode code="ESP" codeSystem="2.16.840.1.113883.5.60" displayName="Expressed spoken"/>

<proficiencyLevelCode code="G" codeSystem="2.16.840.1.113883.5.61" displayName="Good"/>

<preferenceInd value="true"/>

</languageCommunication>

</patient>

<!-- Optional: Provider Organization (e.g., primary care clinic) -->

<providerOrganization>

<id root="2.16.840.1.113883.19.5.99999999"/>

<name>Metropolis Health Center</name>

<telecom value="tel:+1-555-321-7654"/>

<addr>

<streetAddressLine>456 Health Way</streetAddressLine>

<city>Metropolis</city>

<state>NY</state>

<postalCode>10002</postalCode>

<country>US</country>

</addr>

</providerOrganization>

</patientRole>

</recordTarget>

Key Notes:

  • recordTarget/patientRole/id: The patient identifier (root = OID of assigning authority; extension = patient ID).

  • administrativeGenderCode uses values from HL7 v3 code system (2.16.840.1.113883.5.1).

  • raceCode and ethnicGroupCode use CDCREC codes (2.16.840.1.113883.6.238).

  • languageCommunication indicates the patient’s preferred language and communication proficiency.

  • The providerOrganization is optional but often included when the document comes from a specific care delivery organization.