FHIR HumanName Data Type (R4)

HumanName holds a person's name in a structured form, with a use, family name, given names, prefixes and suffixes. Element table, example JSON and FHIRPath for FHIR R4.

FHIR HumanName Data Type (R4) — part of the free FHIR Toolbox library.
Runs entirely in your browser: your FHIR data is never uploaded to a server.

Overview

HumanName holds a person's name in a structured form, with a use, family name, given names, prefixes and suffixes. Patient.name and Practitioner.name are arrays of HumanName.

Elements

Element	Type	Cardinality	Description
HumanName.use	code	0..1	usual \| official \| temp \| nickname \| anonymous \| old \| maiden
HumanName.family	string	0..1	Family name (often called 'Surname')
HumanName.given	string	0..*	Given names (not always 'first'). Includes middle names
HumanName.prefix	string	0..*	Parts that come before the name
HumanName.suffix	string	0..*	Parts that come after the name
HumanName.period	Period	0..1	Time period when name was/is in use

Example JSON (R4)

{
  "use": "official",
  "family": "Smith",
  "given": [
    "John",
    "Michael"
  ],
  "prefix": [
    "Mr."
  ]
}

FHIRPath

Patient.name.where(use='official').given.first() — First given name of the official name
Patient.name.family — All family names

FHIR Toolbox is a free, privacy-first collection of HL7 FHIR utilities by Omindra Labs. Every tool performs zero-server processing — your health data never leaves your device.