A human's name with the ability to identify parts and usage.


For further information, including all W3C International Examples, consult the HL7-FHIR examples. Note: Implementers should read the name examples for a full understanding of how name works.




prefixsymbol0..*Parts that come before the name.
givensymbol0..*Given names (not always 'first'). Includes middle names.
familysymbol0..1The part of a name that links to the genealogy.
suffixsymbol0..*Parts that come after the name.
textsymbol0..1Specifies the entire name as it should be displayed e.g. on an application UI. This may be provided instead of or as well as the specific parts
usecode0..1Purpose of this name.

Proposed values are:
- usual: Known as/conventional/the one you normally use.
- official: The formal name as registered in an official (government) registry, but which name might not be commonly used. May be called "legal name".
- temp: A temporary name. name.period can provide more detailed information. This may also be used for temporary names assigned at birth or in emergency situations.
- nickname: A name that is used to address the person in an informal manner, but is not part of their formal or usual name.
- anonymous: Anonymous assigned name, alias, or pseudonym (used to protect a person's identity for privacy reasons).
- old: This name is no longer in use (or was never correct, but retained for records).
- maiden: A name used prior to changing name because of marriage. Marriage naming customs vary greatly around the world, and are constantly changing. This term is not gender specific. The use of this term does not imply any particular history for a person's name.
periodperiod0..1Time period when name was/is in use.
  "prefix": ["<symbol>"],
  "given": ["<symbol>"],
  "family": "<symbol>",
  "suffix": ["<symbol>"],
  "use": "<code>",
  "period": { Period }