Golden Record Patient (Universal) - Interoperable Digital Identity and Patient Matching v3.0.0-current

Interoperable Digital Identity and Patient Matching, published by HL7 International / Patient Administration. This guide is not an authorized publication; it is the continuous build for version 3.0.0-current built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/fhir-identity-matching-ig/ and changes regularly. See the Directory of published versions

Resource Profile: Golden Record Patient (Universal)

Official URL: http://hl7.org/fhir/us/identity-matching/StructureDefinition/GoldenRecordPatient	Version: 3.0.0-current	Highlight text changes?
Standards status: Trial-use	Maturity Level: 2	Computable Name: GoldenRecordPatient
Other Identifiers: OID:2.16.840.1.113883.4.642.40.81.42.2

Patient carrying a Golden Record Identifier, derived from base FHIR Patient so it is usable by any assigner — EHRs, payers, HIEs, and Credential Service Providers (CSPs) — and portable across realms. Must-support flags express the Golden Record identity boundary (brief §3): core identity attributes are Must Support; contextual data (employment, organizational role, coverage, clinical/USCDI demographics) is intentionally not required by this profile and lives in other resources.

Usages:

Examples for this Profile: Patient/GoldenRecordCSPExampleFromJson, Patient/GoldenRecordMultiCSPExampleFromJson, Patient/GoldenRecordPatientCSPExample, Patient/GoldenRecordPatientExample...

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

Description Differentials, Snapshots, and other representations.

Key Elements Table
Differential Table
Snapshot Table
Statistics/References
All

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Patient		0..*	Patient	Information about an individual or animal receiving health care services
Patient.implicitRules	This element is a modifier element. This element is included in summaries.	0..1	uri	A set of rules under which this content was created
Patient.modifierExtension	This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
Patient.Slices for identifier	This element must be supported. This element is included in summaries.	1..*	Identifier	An identifier for this patient Slice: Unordered, Open by value:type Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Patient.Slices for identifier.identifier:GoldenIdentifier	This element must be supported. This element is included in summaries.	1..*	Identifier	An identifier for this patient
Patient.Slices for identifier.identifier:GoldenIdentifier.use	This element is a modifier element. This element is included in summaries.	0..1	code	usual \| official \| temp \| secondary \| old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Patient.Slices for identifier.identifier:GoldenIdentifier.type	This element must be supported. This element is included in summaries.	1..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: `{ "coding" : [ { "system" : "http://hl7.org/fhir/us/identity-matching/CodeSystem/IdentifierTypes", "code" : "golden" } ] }`
Patient.Slices for identifier.identifier:GoldenIdentifier.system	This element must be supported. This element is included in summaries.	1..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
Patient.Slices for identifier.identifier:GoldenIdentifier.value	This element must be supported. This element is included in summaries.	1..1	string	The value that is unique Example General: 123456
Patient.Slices for identifier.identifier:GoldenIdentifier.period	This element must be supported. This element is included in summaries.	0..1	Period	Time period when id is/was valid for use
Patient.Slices for identifier.identifier:GoldenIdentifier.assigner	This element must be supported. This element is included in summaries.	0..1	Reference(Organization)	Organization that issued id (may be just text)
Patient.active	This element is a modifier element. This element is included in summaries.	0..1	boolean	Whether this patient's record is in active use
Patient.name	This element must be supported. This element is included in summaries.	1..*	HumanName	A name associated with the patient
Patient.telecom	This element must be supported. This element is included in summaries.	0..*	ContactPoint	A contact detail for the individual
Patient.gender	This element must be supported. This element is included in summaries.	0..1	code	male \| female \| other \| unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
Patient.birthDate	This element must be supported. This element is included in summaries.	0..1	date	The date of birth for the individual
Patient.deceased[x]	This element is a modifier element. This element is included in summaries.	0..1		Indicates if the individual is deceased or not
Patient.deceased[x].deceasedBoolean			boolean
Patient.deceased[x].deceasedDateTime			dateTime
Patient.address	This element must be supported. This element is included in summaries.	0..*	Address	An address for the individual
Patient.link	This element is a modifier element. This element is included in summaries.	0..*	BackboneElement	Link to another patient resource that concerns the same actual person
Patient.link.modifierExtension	This element is a modifier element. This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
Patient.link.other	This element is included in summaries.	1..1	Reference(Patient \| RelatedPerson)	The other patient or related person resource that the link refers to
Patient.link.type	This element is included in summaries.	1..1	code	replaced-by \| replaces \| refer \| seealso Binding: LinkType (required): The type of link between this patient resource and another patient resource.
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Patient.identifier:GoldenIdentifier.use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:GoldenIdentifier.type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Patient.link.type	Base	required	LinkType	📍4.0.1	FHIR Std.

Constraints

Grade

Path(s)

Description

Expression

This structure is derived from Patient

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Patient		0..*	Patient	Information about an individual or animal receiving health care services
Patient.Slices for identifier	This element must be supported.	1..*	Identifier	An identifier for this patient Slice: Unordered, Open by value:type Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Patient.Slices for identifier.identifier:GoldenIdentifier	This element must be supported.	1..*	Identifier	An identifier for this patient
Patient.Slices for identifier.identifier:GoldenIdentifier.type	This element must be supported.	1..1	CodeableConcept	Description of identifier Required Pattern: `{ "coding" : [ { "system" : "http://hl7.org/fhir/us/identity-matching/CodeSystem/IdentifierTypes", "code" : "golden" } ] }`
Patient.Slices for identifier.identifier:GoldenIdentifier.system	This element must be supported.	1..1	uri	The namespace for the identifier value
Patient.Slices for identifier.identifier:GoldenIdentifier.value	This element must be supported.	1..1	string	The value that is unique
Patient.Slices for identifier.identifier:GoldenIdentifier.period	This element must be supported.	0..1	Period	Time period when id is/was valid for use
Patient.Slices for identifier.identifier:GoldenIdentifier.assigner	This element must be supported.	0..1	Reference(Organization)	Organization that issued id (may be just text)
Patient.name	This element must be supported.	1..*	HumanName	A name associated with the patient
Patient.telecom	This element must be supported.	0..*	ContactPoint	A contact detail for the individual
Patient.gender	This element must be supported.	0..1	code	male \| female \| other \| unknown
Patient.birthDate	This element must be supported.	0..1	date	The date of birth for the individual
Patient.address	This element must be supported.	0..*	Address	An address for the individual
Documentation for this format

Description & Constraints Filter:

Patient 0..* Patient Information about an individual or animal receiving health care services

Patient.id This element is included in summaries. 0..1 id Logical id of this artifact

Patient.meta This element is included in summaries. 0..1 Meta Metadata about the resource

Patient.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created

language

0..1

code

Language of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional Bindings

Purpose

AllLanguages

Max Binding

Patient.text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements

Patient.contained 0..* Resource Contained, inline Resources

Patient.extension 0..* Extension Additional content defined by implementations

Patient.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored

Patient.Slices for identifier This element must be supported. This element is included in summaries. 1..* Identifier An identifier for this patient
Slice: Unordered, Open by value:type

Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them

Patient.Slices for identifier.identifier:GoldenIdentifier This element must be supported. This element is included in summaries. 1..* Identifier An identifier for this patient

Patient.Slices for identifier.identifier:GoldenIdentifier.id 0..1 string Unique id for inter-element referencing

Patient.Slices for identifier.identifier:GoldenIdentifier.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url

Patient.Slices for identifier.identifier:GoldenIdentifier.use This element is a modifier element. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .

type

1..1

CodeableConcept

Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
Required Pattern:

{
  "coding" : [
    {
      "system" : "http://hl7.org/fhir/us/identity-matching/CodeSystem/IdentifierTypes",
      "code" : "golden"
    }
  ]
}

Patient.Slices for identifier.identifier:GoldenIdentifier.system This element must be supported. This element is included in summaries. 1..1 uri The namespace for the identifier value
Example General: http://www.acme.com/identifiers/patient

Patient.Slices for identifier.identifier:GoldenIdentifier.value This element must be supported. This element is included in summaries. 1..1 string The value that is unique
Example General: 123456

Patient.Slices for identifier.identifier:GoldenIdentifier.period This element must be supported. This element is included in summaries. 0..1 Period Time period when id is/was valid for use

Patient.Slices for identifier.identifier:GoldenIdentifier.assigner This element must be supported. This element is included in summaries. 0..1 Reference(Organization) Organization that issued id (may be just text)

Patient.active This element is a modifier element. This element is included in summaries. 0..1 boolean Whether this patient's record is in active use

Patient.name This element must be supported. This element is included in summaries. 1..* HumanName A name associated with the patient

Patient.telecom This element must be supported. This element is included in summaries. 0..* ContactPoint A contact detail for the individual

Patient.gender This element must be supported. This element is included in summaries. 0..1 code male | female | other | unknown
Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.

Patient.birthDate This element must be supported. This element is included in summaries. 0..1 date The date of birth for the individual

Patient.deceased[x] This element is a modifier element. This element is included in summaries. 0..1 Indicates if the individual is deceased or not

Patient.deceased[x].deceasedBoolean boolean

Patient.deceased[x].deceasedDateTime dateTime

Patient.address This element must be supported. This element is included in summaries. 0..* Address An address for the individual

Patient.maritalStatus 0..1 CodeableConcept Marital (civil) status of a patient
Binding: Marital Status Codes (extensible): The domestic partnership status of a person.

Patient.multipleBirth[x] 0..1 Whether patient is part of a multiple birth

Patient.multipleBirth[x].multipleBirthBoolean boolean

Patient.multipleBirth[x].multipleBirthInteger integer

Patient.photo 0..* Attachment Image of the patient

Patient.contact C 0..* BackboneElement A contact party (e.g. guardian, partner, friend) for the patient
Constraints: pat-1

Patient.contact.id 0..1 string Unique id for inter-element referencing

Patient.contact.extension 0..* Extension Additional content defined by implementations

Patient.contact.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized

Patient.contact.relationship 0..* CodeableConcept The kind of relationship
Binding: PatientContactRelationship (extensible): The nature of the relationship between a patient and a contact person for that patient.

Patient.contact.name 0..1 HumanName A name associated with the contact person

Patient.contact.telecom 0..* ContactPoint A contact detail for the person

Patient.contact.address 0..1 Address Address for the contact person

Patient.contact.gender 0..1 code male | female | other | unknown
Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.

Patient.contact.organization C 0..1 Reference(Organization) Organization that is associated with the contact

Patient.contact.period 0..1 Period The period during which this contact person or organization is valid to be contacted relating to this patient

Patient.communication 0..* BackboneElement A language which may be used to communicate with the patient about his or her health

Patient.communication.id 0..1 string Unique id for inter-element referencing

Patient.communication.extension 0..* Extension Additional content defined by implementations

Patient.communication.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized

language

1..1

CodeableConcept

The language which can be used to communicate with the patient about his or her health
Binding: CommonLanguages (preferred): A human language.

Additional Bindings

Purpose

AllLanguages

Max Binding

Patient.communication.preferred 0..1 boolean Language preference indicator

Patient.generalPractitioner 0..* Reference(Organization | Practitioner | PractitionerRole) Patient's nominated primary care provider

Patient.managingOrganization This element is included in summaries. 0..1 Reference(Organization) Organization that is the custodian of the patient record

Patient.link This element is a modifier element. This element is included in summaries. 0..* BackboneElement Link to another patient resource that concerns the same actual person

Patient.link.id 0..1 string Unique id for inter-element referencing

Patient.link.extension 0..* Extension Additional content defined by implementations

Patient.link.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension Extensions that cannot be ignored even if unrecognized

Patient.link.other This element is included in summaries. 1..1 Reference(Patient | RelatedPerson) The other patient or related person resource that the link refers to

Patient.link.type This element is included in summaries. 1..1 code replaced-by | replaces | refer | seealso
Binding: LinkType (required): The type of link between this patient resource and another patient resource.

Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Patient.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Patient.identifier:GoldenIdentifier.use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:GoldenIdentifier.type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Patient.maritalStatus	Base	extensible	MaritalStatus	📍4.0.1	FHIR Std.
Patient.contact.relationship	Base	extensible	Patient Contact Relationship	📍4.0.1	FHIR Std.
Patient.contact.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Patient.communication.language	Base	preferred	Common Languages	📍4.0.1	FHIR Std.
Patient.link.type	Base	required	LinkType	📍4.0.1	FHIR Std.

Constraints

Grade

Path(s)

Description

Expression

This structure is derived from Patient

Summary

Mandatory: 6 elements
Must-Support: 12 elements

Slices

This structure defines the following Slices:

The element 1 is sliced based on the value of Patient.identifier

Maturity: 2

Key Elements View

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Patient		0..*	Patient	Information about an individual or animal receiving health care services
Patient.implicitRules	This element is a modifier element. This element is included in summaries.	0..1	uri	A set of rules under which this content was created
Patient.modifierExtension	This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
Patient.Slices for identifier	This element must be supported. This element is included in summaries.	1..*	Identifier	An identifier for this patient Slice: Unordered, Open by value:type Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Patient.Slices for identifier.identifier:GoldenIdentifier	This element must be supported. This element is included in summaries.	1..*	Identifier	An identifier for this patient
Patient.Slices for identifier.identifier:GoldenIdentifier.use	This element is a modifier element. This element is included in summaries.	0..1	code	usual \| official \| temp \| secondary \| old (If known) Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
Patient.Slices for identifier.identifier:GoldenIdentifier.type	This element must be supported. This element is included in summaries.	1..1	CodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose. Required Pattern: `{ "coding" : [ { "system" : "http://hl7.org/fhir/us/identity-matching/CodeSystem/IdentifierTypes", "code" : "golden" } ] }`
Patient.Slices for identifier.identifier:GoldenIdentifier.system	This element must be supported. This element is included in summaries.	1..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
Patient.Slices for identifier.identifier:GoldenIdentifier.value	This element must be supported. This element is included in summaries.	1..1	string	The value that is unique Example General: 123456
Patient.Slices for identifier.identifier:GoldenIdentifier.period	This element must be supported. This element is included in summaries.	0..1	Period	Time period when id is/was valid for use
Patient.Slices for identifier.identifier:GoldenIdentifier.assigner	This element must be supported. This element is included in summaries.	0..1	Reference(Organization)	Organization that issued id (may be just text)
Patient.active	This element is a modifier element. This element is included in summaries.	0..1	boolean	Whether this patient's record is in active use
Patient.name	This element must be supported. This element is included in summaries.	1..*	HumanName	A name associated with the patient
Patient.telecom	This element must be supported. This element is included in summaries.	0..*	ContactPoint	A contact detail for the individual
Patient.gender	This element must be supported. This element is included in summaries.	0..1	code	male \| female \| other \| unknown Binding: AdministrativeGender (required): The gender of a person used for administrative purposes.
Patient.birthDate	This element must be supported. This element is included in summaries.	0..1	date	The date of birth for the individual
Patient.deceased[x]	This element is a modifier element. This element is included in summaries.	0..1		Indicates if the individual is deceased or not
Patient.deceased[x].deceasedBoolean			boolean
Patient.deceased[x].deceasedDateTime			dateTime
Patient.address	This element must be supported. This element is included in summaries.	0..*	Address	An address for the individual
Patient.link	This element is a modifier element. This element is included in summaries.	0..*	BackboneElement	Link to another patient resource that concerns the same actual person
Patient.link.modifierExtension	This element is a modifier element. This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
Patient.link.other	This element is included in summaries.	1..1	Reference(Patient \| RelatedPerson)	The other patient or related person resource that the link refers to
Patient.link.type	This element is included in summaries.	1..1	code	replaced-by \| replaces \| refer \| seealso Binding: LinkType (required): The type of link between this patient resource and another patient resource.
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
Patient.identifier:GoldenIdentifier.use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Patient.identifier:GoldenIdentifier.type	Base	extensible	IdentifierType	📍4.0.1	FHIR Std.
Patient.gender	Base	required	AdministrativeGender	📍4.0.1	FHIR Std.
Patient.link.type	Base	required	LinkType	📍4.0.1	FHIR Std.

Constraints

Grade

Path(s)

Description

Expression

Differential View

This structure is derived from Patient

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Patient		0..*	Patient	Information about an individual or animal receiving health care services
Patient.Slices for identifier	This element must be supported.	1..*	Identifier	An identifier for this patient Slice: Unordered, Open by value:type Slicing Note: The rules on this element (including its children) apply to all the slices, but are not repeated in them
Patient.Slices for identifier.identifier:GoldenIdentifier	This element must be supported.	1..*	Identifier	An identifier for this patient
Patient.Slices for identifier.identifier:GoldenIdentifier.type	This element must be supported.	1..1	CodeableConcept	Description of identifier Required Pattern: `{ "coding" : [ { "system" : "http://hl7.org/fhir/us/identity-matching/CodeSystem/IdentifierTypes", "code" : "golden" } ] }`
Patient.Slices for identifier.identifier:GoldenIdentifier.system	This element must be supported.	1..1	uri	The namespace for the identifier value
Patient.Slices for identifier.identifier:GoldenIdentifier.value	This element must be supported.	1..1	string	The value that is unique
Patient.Slices for identifier.identifier:GoldenIdentifier.period	This element must be supported.	0..1	Period	Time period when id is/was valid for use
Patient.Slices for identifier.identifier:GoldenIdentifier.assigner	This element must be supported.	0..1	Reference(Organization)	Organization that issued id (may be just text)
Patient.name	This element must be supported.	1..*	HumanName	A name associated with the patient
Patient.telecom	This element must be supported.	0..*	ContactPoint	A contact detail for the individual
Patient.gender	This element must be supported.	0..1	code	male \| female \| other \| unknown
Patient.birthDate	This element must be supported.	0..1	date	The date of birth for the individual
Patient.address	This element must be supported.	0..*	Address	An address for the individual
Documentation for this format

Snapshot ViewView

Description & Constraints Filter:

Patient 0..* Patient Information about an individual or animal receiving health care services

Patient.id This element is included in summaries. 0..1 id Logical id of this artifact

Patient.meta This element is included in summaries. 0..1 Meta Metadata about the resource

Patient.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri A set of rules under which this content was created

language

0..1

code

Language of the resource content
Binding: CommonLanguages (preferred): A human language.

Additional Bindings

Purpose

AllLanguages

Max Binding

Patient.text 0..1 Narrative Text summary of the resource, for human interpretation
This profile does not constrain the narrative in regard to content, language, or traceability to data elements

Patient.contained 0..* Resource Contained, inline Resources

Patient.extension 0..* Extension Additional content defined by implementations

Patient.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored

Patient.Slices for identifier.identifier:GoldenIdentifier This element must be supported. This element is included in summaries. 1..* Identifier An identifier for this patient

Patient.Slices for identifier.identifier:GoldenIdentifier.id 0..1 string Unique id for inter-element referencing

Patient.Slices for identifier.identifier:GoldenIdentifier.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url

type

1..1

CodeableConcept

Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
Required Pattern:

{
  "coding" : [
    {
      "system" : "http://hl7.org/fhir/us/identity-matching/CodeSystem/IdentifierTypes",
      "code" : "golden"
    }
  ]
}