Demographics

The SHR Demographics domain contains definitions that describe basic characteristics of the person of record, such as name, address, and date of birth. Elements in the demographics domains are used for unique identification and patient matching.

AddressUse

Describes how the address is used, in particular, as a dwelling (primary, secondary, temporary), a former address, mailing address, etc.

Value:  CodeableConcept from AddressUseVS A set of codes drawn from different coding systems, representing the same concept.

AddressUsed

An address used by for dwelling, work, or other purposes. May be a physical location or an address used only for deliveries, such as a PO box. C0682130

Value:  Address An address expressed using postal conventions (as opposed to GPS or other location definition formats). This data type may be used to convey addresses for use in delivering mail as well as for visiting locations and which might not be valid for mail delivery. There are a variety of postal address formats defined around the world. (Source: HL7 FHIR).
AddressUse 1 or more Describes how the address is used, in particular, as a dwelling (primary, secondary, temporary), a former address, mailing address, etc.
Setting 0 or more Description of the place or type of surroundings where something is positioned or where an event takes place.
EffectiveTimePeriod optional The date and time span for which something is active, valid, or in force.

BirthSex

Administrative sex assigned at birth and recorded on birth certificate. C4086849

Value:  CodeableConcept from http://hl7.org/fhir/us/core/ValueSet/us-core-birthsex A set of codes drawn from different coding systems, representing the same concept.

CountryOfIssue

A country acting as an assuing authority for a document.

Value:  Country Country - a nation as commonly understood or generally accepted, expressed in ISO 3166 Alpha-2 (2-letter) codes.

DriversLicenseNumber

Identifying information from a drivers license.

Value:  string
StateOfIssue required Issuing authority for a drivers license.
EffectiveTimePeriod optional The date and time span for which something is active, valid, or in force.

Ethnicity

Indicator of Hispanic or Latino origin. C0015031

Value:  CodeableConcept from http://hl7.org/fhir/us/core/ValueSet/omb-ethnicity A set of codes drawn from different coding systems, representing the same concept.
EthnicityDetail 0 or more Additional description of ethnicity.

EthnicityDetail

Additional description of ethnicity.

Value:  Choice
         |  CodeableConcept from http://hl7.org/fhir/us/core/ValueSet/omb-ethnicity required A set of codes drawn from different coding systems, representing the same concept.
         |  CodeableConcept from http://hl7.org/fhir/us/core/ValueSet/detailed-ethnicity required A set of codes drawn from different coding systems, representing the same concept.

FamilialRelationship

The relationship of the subject to another person in the same (extended) family. May or may not be a blood relative (determined by value). Can be used to indicate there is no relation of the given type (e.g., no siblings), using the NonOccurrenceModifier. C0015608

Value:  CodeableConcept from http://hl7.org/fhir/ValueSet/relatedperson-relationshiptype A set of codes drawn from different coding systems, representing the same concept.
Choice optional
         |  RelatedPerson required A person, other than a practitioner or the patient (the person of record) who is relevant to the health or social situation of the subject.
         |  Practitioner required A person who practices a healing art.
NonOccurrenceModifier optional When true, indicates either that the event or action documented in the entry did not occur, or the the thing documented is absent or does not exist.

FathersName

The name of the father as it was or likely to have been recorded on the birth certificate of the subject; most likely the name of the father at the time of birth of the subject.

Value:  HumanName A name used by a human being, written as it would be typically expressed. May include a breakdown of the various elements of the name (family name, given name, etc.).

HealthInsurance [Entry]

Health insurance coverage available (even if not used for payment for a given encounter). HealthInsurance (C0021682)

Value:  CodeableConcept from InsuranceProviderTypeVS A set of codes drawn from different coding systems, representing the same concept.
InsuranceMemberId optional Patient identifier at a healthcare provider, insurer, or other related organization.
EffectiveTimePeriod optional The date and time span for which something is active, valid, or in force.

HomeTelephoneNumber

A telephone number associated with a person's residence.

Based On TelephoneNumber

Value:  TelecomNumberOrAddress A user name or other identifier on a telecommunication network, such as a telephone number (including country code and extension, if necessary), email address, or SkypeID.
TelecomQualifier is home optional Provides more information about the type and uses of the telecom address.
TelecomType from TelephoneTypeVS required The type or channel of the communication, such as email or telephone. If an messaging app, such as Skype, specify other.
TelecomTypeOther optional Specification of the type of telecom channel, if the TelecomType is other.
EffectiveTimePeriod optional The date and time span for which something is active, valid, or in force.

InsuranceMemberId

Patient identifier at a healthcare provider, insurer, or other related organization.

Value:  string

MaritalStatus

The most recent marital status of a person. C0024819

Value:  CodeableConcept from http://hl7.org/fhir/ValueSet/marital-status A set of codes drawn from different coding systems, representing the same concept.

MedicalInterpreterNeeded

Whether the subject requires an interpreter to communicate with an English-speaking provider. C1442531

Value:  boolean
Language required A human language, spoken or written.

MothersMaidenName

The name of the mother as it was or likely to have been recorded on the birth certificate of the subject. This is most likely the name prior to marriage of the mother (aka the maiden name). C0806887

Value:  HumanName A name used by a human being, written as it would be typically expressed. May include a breakdown of the various elements of the name (family name, given name, etc.).

MultipleBirth

Indication if the person was part of a multiple birth event. C0026753

Value:  boolean
MultipleBirthOrder optional Order of birth of the person in multiple birth event (if part of multiple birth).

MultipleBirthOrder

Order of birth of the person in multiple birth event (if part of multiple birth). 73771-8

Value:  integer

PassportNumber

Indicator of citizenship and identity. C1549737

Value:  string
CountryOfIssue required A country acting as an assuing authority for a document.
EffectiveTimePeriod optional The date and time span for which something is active, valid, or in force.

PersonOfRecord [Entry]

Extended demographic information about the subject of this SHR. C1299487 54125-0

Based On Person

Value:  HumanName A name used by a human being, written as it would be typically expressed. May include a breakdown of the various elements of the name (family name, given name, etc.).
DateOfBirth required A date of birth or approximate year or period (year or date range), if estimated.
PlaceOfBirth required The location of a birth event. There may be multiple entries, but a person has only one place of birth.
MultipleBirth optional Indication if the person was part of a multiple birth event.
BirthSex required Administrative sex assigned at birth and recorded on birth certificate.
AdministrativeGender required A gender classification used for administrative purposes. Administrative gender is not necessarily the same as a biological description or a gender identity. This attribute does not include terms related to clinical gender.
Race required Subjective association of a person with a named category of humans sharing common history, traits, place of family origin, nationality, tribe, or other inherited background.
Ethnicity required Indicator of Hispanic or Latino origin.
MaritalStatus required The most recent marital status of a person.
MothersMaidenName required The name of the mother as it was or likely to have been recorded on the birth certificate of the subject. This is most likely the name prior to marriage of the mother (aka the maiden name).
FathersName required The name of the father as it was or likely to have been recorded on the birth certificate of the subject; most likely the name of the father at the time of birth of the subject.
SocialSecurityNumber optional A US social security number (SSN).
DriversLicenseNumber 0 or more Identifying information from a drivers license.
PassportNumber 0 or more Indicator of citizenship and identity.
AddressUsed 1 or more An address used by for dwelling, work, or other purposes. May be a physical location or an address used only for deliveries, such as a PO box.
Telecom 1 or more An electronic means of contacting an organization or individual.
LanguageUsed 1 or more Language used for communication by a human, either the subject of record, parent, or other involved person.
MedicalInterpreterNeeded optional Whether the subject requires an interpreter to communicate with an English-speaking provider.
FamilialRelationship 0 or more The relationship of the subject to another person in the same (extended) family. May or may not be a blood relative (determined by value). Can be used to indicate there is no relation of the given type (e.g., no siblings), using the NonOccurrenceModifier.
Anonymized optional Flag indicating if personally identifiable information has been withheld.
FictionalPerson optional Flag indicating if this record represents a fictional (synthetic, not real) person.
Deceased optional An indication that the person is no longer living, given by a date, time of death, or a boolean value which, when true, indicates the person is deceased.

PlaceOfBirth

The location of a birth event. There may be multiple entries, but a person has only one place of birth. C0032040

Value:  GeopoliticalLocation The countries of the world and major geopolitical subregions, such as US states.

Race

Subjective association of a person with a named category of humans sharing common history, traits, place of family origin, nationality, tribe, or other inherited background. C0034510

Value:  CodeableConcept from http://hl7.org/fhir/us/core/ValueSet/omb-ethnicity A set of codes drawn from different coding systems, representing the same concept.
RaceDetail 0 or more Additional description of race or heritage.

RaceDetail

Additional description of race or heritage.

Value:  Choice
         |  CodeableConcept from http://hl7.org/fhir/us/core/ValueSet/detailed-race required A set of codes drawn from different coding systems, representing the same concept.
         |  CodeableConcept from http://hl7.org/fhir/us/core/ValueSet/omb-ethnicity required A set of codes drawn from different coding systems, representing the same concept.

SocialSecurityNumber

A US social security number (SSN). C1301821

Value:  string

StateOfIssue

Issuing authority for a drivers license. C1547728

Value:  State Sub-unit of a country with limited sovereignty in a federally organized country. A code may be used if codes are in common use (i.e. US 2 letter state codes). (Source: HL7 FHIR).

Telecom

An electronic means of contacting an organization or individual. C2986441

Value:  TelecomNumberOrAddress A user name or other identifier on a telecommunication network, such as a telephone number (including country code and extension, if necessary), email address, or SkypeID.
TelecomType required The type or channel of the communication, such as email or telephone. If an messaging app, such as Skype, specify other.
TelecomTypeOther optional Specification of the type of telecom channel, if the TelecomType is other.
TelecomQualifier optional Provides more information about the type and uses of the telecom address.
EffectiveTimePeriod optional The date and time span for which something is active, valid, or in force.

TelecomNumberOrAddress

A user name or other identifier on a telecommunication network, such as a telephone number (including country code and extension, if necessary), email address, or SkypeID.

Value:  string

TelecomQualifier

Provides more information about the type and uses of the telecom address.

Value:  code from http://hl7.org/fhir/ValueSet/contact-point-use

TelecomType

The type or channel of the communication, such as email or telephone. If an messaging app, such as Skype, specify other.

Value:  code from http://hl7.org/fhir/ValueSet/contact-point-system

TelecomTypeOther

Specification of the type of telecom channel, if the TelecomType is other.

Value:  string

TelephoneNumber

A sequence of decimal digits (0-9) that is used for identifying a destination telephone line or other device in a telephone network. C1515258

Based On Telecom

Value:  TelecomNumberOrAddress A user name or other identifier on a telecommunication network, such as a telephone number (including country code and extension, if necessary), email address, or SkypeID.
TelecomType from TelephoneTypeVS required The type or channel of the communication, such as email or telephone. If an messaging app, such as Skype, specify other.
TelecomTypeOther optional Specification of the type of telecom channel, if the TelecomType is other.
TelecomQualifier optional Provides more information about the type and uses of the telecom address.
EffectiveTimePeriod optional The date and time span for which something is active, valid, or in force.

WorkTelephoneNumber

A telephone number associated with a person's residence.

Based On TelephoneNumber

Value:  TelecomNumberOrAddress A user name or other identifier on a telecommunication network, such as a telephone number (including country code and extension, if necessary), email address, or SkypeID.
TelecomQualifier is work optional Provides more information about the type and uses of the telecom address.
TelecomType from TelephoneTypeVS required The type or channel of the communication, such as email or telephone. If an messaging app, such as Skype, specify other.
TelecomTypeOther optional Specification of the type of telecom channel, if the TelecomType is other.
EffectiveTimePeriod optional The date and time span for which something is active, valid, or in force.