FHIR © HL7.org  |  FHIRsmith 4.0.1  |  Server Home  |  XIG Home  |  XIG Stats  | 

FHIR IG analytics

Packagehl7.fhir.us.identity-matching
Resource TypeStructureDefinition
IdStructureDefinition-identity-assertion.json
FHIR VersionR4
Sourcehttps://build.fhir.org/ig/HL7/fhir-identity-matching-ig/StructureDefinition-identity-assertion.html
URLhttp://hl7.org/fhir/us/identity-matching/StructureDefinition/identity-assertion
Version3.0.0-current
Statusactive
Date2026-10-01T12:59:11+00:00
NameIdentityAssertion
TitleIdentity Assertion
Realmus
Authorityhl7
DescriptionA representation of asserted identity information, including names, postal addresses, and phone numbers with their validity periods. - Informed by [TEFCA IAS SOP](https://rce.sequoiaproject.org/wp-content/uploads/2024/08/XP-Implementation-SOP-IAS.pdf) - Informed by FHIR [Patient resource](https://hl7.org/fhir/R4/patient.html) - Informed by US-Core [Patient Profile](https://build.fhir.org/ig/HL7/US-Core/StructureDefinition-us-core-patient.html)
Typehttp://hl7.org/fhir/us/identity-matching/StructureDefinition/identity-assertion
Kindlogical

Resources that use this resource

No resources found


Resources that this resource uses

No resources found


Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: StructureDefinition identity-assertion

NameFlagsCard.TypeDescription & Constraintsdoco
.. identity-assertion 0..*BaseIdentity Assertion
... masterIdentifier 1..1stringThe master identifier
.... system 1..1stringThe system of the master identifier
.... @value 1..1stringThe identifier value
... names 1..*BackboneElementThe person's names
.... first 1..1stringThe first name
.... middle 0..*stringThe middle names
.... last 1..1stringThe last name
.... prefix 0..1stringThe prefix
.... suffix 0..1stringThe suffix
.... validityPeriod 0..1PeriodThe validity of this name
... addresses 0..*AddressPhysical addresses
.... period 0..1PeriodThe validity of this address
.... use 0..1codehome | work | temp | old | billing
.... type 0..1codepostal | physical | both
.... line 0..*stringThe street address
.... city 1..1stringThe city of the address
.... state 1..1stringThe state of the address
.... postalCode 0..1stringThe postal code
.... country 0..1stringThe country of the address
... phoneNumbers 0..*BackboneElementPhone numbers
.... number 1..1stringThe phone number
.... validityPeriod 0..1PeriodThe validity of this number
.... type 0..1codephone | fax | pager | url | sms | other
.... use 0..1codehome | work | temp | old | mobile
.... rank 0..1integerSpecify preferred order of use (1 = highest)
... emails 0..*BackboneElementEmail addresses or direct messaging
.... address 1..1stringThe email address
.... validityPeriod 0..1PeriodThe validity of this email
.... type 0..1codework | personal
... ssn 0..*stringThe social security number
... identifiers 0..*BackboneElementCorrelated external Identifiers
.... value 1..1stringThe identifier value
.... system 0..1stringThe identifier system URL
.... type 0..1codeThe identifier type
.... validityPeriod 0..1PeriodThe validity of this identifier
.... issuer 0..1stringThe issuer of this identifier
... birthDate 0..1dateThe birth date
... photo 0..1AttachmentThe person's photo
... gender 0..1codemale | female | other | unknown
... maritalStatus 0..1codeunmarried | married | annulled | divorced
... race 0..1codeAsked but unknown | Asked but declined | unknown | American Indian | Asian | Black | Native Hawaiian | White | Other
... ethnicity 0..1codeThe ethnicity of the person
... tribalAffiliation 0..1codeTribal affiliation
... religion 0..1codeThe religion of the person
... placeOfBirth 0..1stringThe place of birth
... placeOfDeath 0..1stringThe place of death
... deathDate 0..1dateThe date of death
... causeOfDeath 0..1codeThe cause of death
... assuranceLevel 0..1codeThe level of assurance
... verificationStatus 0..1codeThe verification status
... assuranceDate 0..1dateThe date of assurance
... assuranceMethod 0..1codeThe method of assurance
... contact 0..*BackboneElementEmergency contacts
.... relationship 0..1codeRelationship to the person
.... name 0..1stringName of contact
.... phone 0..1stringPhone of contact
.... email 0..1stringEmail of contact
.... address 0..1stringAddress of contact
.... gender 0..1codeGender of contact
.... period 0..1PeriodContact period
... communication 0..*BackboneElementLanguages spoken
.... language 0..1codeLanguage
.... preferred 0..1booleanPreferred language
... generalPractitioner 0..*BackboneElementGeneral practitioners
... managingOrganization 0..1stringManaging organization

doco Documentation for this format

Source1

{
  "resourceType": "StructureDefinition",
  "id": "identity-assertion",
  "text": {
    "status": "extensions",
    "div": "<!-- snip (see above) -->"
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
      "valueCode": "pa"
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
      "valueInteger": 2,
      "_valueInteger": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/us/identity-matching/ImplementationGuide/hl7.fhir.us.identity-matching"
          }
        ]
      }
    },
    {
      "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
      "valueCode": "trial-use",
      "_valueCode": {
        "extension": [
          {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-conformance-derivedFrom",
            "valueCanonical": "http://hl7.org/fhir/us/identity-matching/ImplementationGuide/hl7.fhir.us.identity-matching"
          }
        ]
      }
    }
  ],
  "url": "http://hl7.org/fhir/us/identity-matching/StructureDefinition/identity-assertion",
  "identifier": [
    {
      "system": "urn:ietf:rfc:3986",
      "value": "urn:oid:2.16.840.1.113883.4.642.40.81.42.19"
    }
  ],
  "version": "3.0.0-current",
  "name": "IdentityAssertion",
  "title": "Identity Assertion",
  "status": "active",
  "date": "2026-10-01T12:59:11+00:00",
  "publisher": "HL7 International / Patient Administration",
  "contact": [
    {
      "name": "HL7 International / Patient Administration",
      "telecom": [
        {
          "system": "url",
          "value": "http://www.hl7.org/Special/committees/pafm"
        }
      ]
    }
  ],
  "description": "A representation of asserted identity information, including names, postal addresses, and phone numbers with their validity periods.\n\n- Informed by [TEFCA IAS SOP](https://rce.sequoiaproject.org/wp-content/uploads/2024/08/XP-Implementation-SOP-IAS.pdf)\n- Informed by FHIR [Patient resource](https://hl7.org/fhir/R4/patient.html)\n- Informed by US-Core [Patient Profile](https://build.fhir.org/ig/HL7/US-Core/StructureDefinition-us-core-patient.html)",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "urn:iso:std:iso:3166",
          "code": "US"
        }
      ]
    }
  ],
  "fhirVersion": "4.0.1",
  "mapping": [
    {
      "identity": "identity-assertion-to-patient",
      "uri": "http://hl7.org/fhir/StructureDefinition/Patient",
      "name": "Identity Assertion to FHIR Patient",
      "comment": "Informative mapping from IdentityAssertion elements to corresponding FHIR R4 Patient elements. Fields without a Patient element or standard extension are not mapped."
    },
    {
      "identity": "identity-assertion-to-oidc-token",
      "uri": "http://hl7.org/fhir/us/identity-matching/StructureDefinition/oidc-token",
      "name": "Identity Assertion to OpenID Connect ID Token",
      "comment": "Informative mapping from identity attributes to the local OIDCToken logical model. Registered JWT claims are represented by OIDCToken but are token-issuance metadata and are not derived from IdentityAssertion."
    },
    {
      "identity": "identity-assertion-to-oor-ecr",
      "uri": "https://github.com/GLEIF-IT/vlei-trainings/blob/main/markdown/103_10_vLEI_Trust_Chain.md",
      "name": "Identity Assertion to Person-Bearing OOR/ECR vLEI Credential",
      "comment": "Informative mapping to the person-bearing OOR/ECR credential attributes shown in GLEIF's vLEI technical examples. GLEIF describes vLEI as combining the legal entity, an individual's identity, and their organizational role ([vLEI overview](https://www.gleif.org/en/organizational-identity/lei-vlei/the-verifiable-lei-vlei)). The OOR/ECR examples use `LEI` and `personLegalName`, with `officialRole` for OOR and `engagementContextRole` for ECR ([GLEIF vLEI trust-chain examples](https://github.com/GLEIF-IT/vlei-trainings/blob/main/markdown/103_10_vLEI_Trust_Chain.md); [QVI issuance workflow](https://github.com/GLEIF-IT/qvi-software/blob/main/qvi-workflow/kli_only/vlei-workflow.sh)).\n\nThe exact credential schema is identified and validated using its SAID. This mapping uses the example attribute names and is not a substitute for resolving and validating the issued OOR/ECR credential. IdentityAssertion has no organizational-role or engagement-context element, so those credential attributes are not mapped."
    },
    {
      "identity": "identity-assertion-to-us-core-patient",
      "uri": "http://hl7.org/fhir/us/core/StructureDefinition/us-core-patient",
      "name": "Identity Assertion to US Core Patient",
      "comment": "Informative mapping from IdentityAssertion elements to the US Core 6.1.0 Patient profile. Fields without a Patient element or standard extension are not mapped."
    }
  ],
  "kind": "logical",
  "abstract": false,
  "type": "http://hl7.org/fhir/us/identity-matching/StructureDefinition/identity-assertion",
  "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Base",
  "derivation": "specialization",
  "snapshot": {
    "extension": [
      {
        "url": "http://hl7.org/fhir/tools/StructureDefinition/snapshot-base-version",
        "valueString": "4.0.1"
      }
    ],
    "element": [
      {
        "id": "identity-assertion",
        "path": "identity-assertion",
        "short": "Identity Assertion",
        "definition": "A representation of asserted identity information, including names, postal addresses, and phone numbers with their validity periods.\n\n- Informed by [TEFCA IAS SOP](https://rce.sequoiaproject.org/wp-content/uploads/2024/08/XP-Implementation-SOP-IAS.pdf)\n- Informed by FHIR [Patient resource](https://hl7.org/fhir/R4/patient.html)\n- Informed by US-Core [Patient Profile](https://build.fhir.org/ig/HL7/US-Core/StructureDefinition-us-core-patient.html)",
        "min": 0,
        "max": "*",
        "base": {
          "path": "Base",
          "min": 0,
          "max": "*"
        },
        "isModifier": false,
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken"
          },
          {
            "identity": "identity-assertion-to-oor-ecr",
            "map": "OOR/ECR credential attributes"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient"
          }
        ]
      },
      {
        "id": "identity-assertion.masterIdentifier",
        "path": "identity-assertion.masterIdentifier",
        "short": "The master identifier",
        "definition": "The master identifier",
        "min": 1,
        "max": "1",
        "base": {
          "path": "identity-assertion.masterIdentifier",
          "min": 1,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier"
          }
        ]
      },
      {
        "id": "identity-assertion.masterIdentifier.id",
        "path": "identity-assertion.masterIdentifier.id",
        "representation": [
          "xmlAttr"
        ],
        "short": "xml:id (or equivalent in JSON)",
        "definition": "unique id for the element within a resource (for internal references)",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Element.id",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "extension": [
              {
                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                "valueUrl": "string"
              }
            ],
            "code": "http://hl7.org/fhirpath/System.String"
          }
        ],
        "isModifier": false,
        "isSummary": false
      },
      {
        "id": "identity-assertion.masterIdentifier.extension",
        "path": "identity-assertion.masterIdentifier.extension",
        "short": "Additional content defined by implementations",
        "definition": "May be used to represent additional information that is not part of the basic definition of the resource. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "alias": [
          "extensions",
          "user content"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "Element.extension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), 'value')])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": false,
        "isSummary": false
      },
      {
        "id": "identity-assertion.masterIdentifier.value",
        "path": "identity-assertion.masterIdentifier.value",
        "representation": [
          "xmlAttr"
        ],
        "short": "The identifier value",
        "definition": "The identifier value",
        "min": 1,
        "max": "1",
        "base": {
          "path": "string.value",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "maxLength": 1048576,
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.value"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.sub",
            "comment": "Use only when this is the subject identifier assigned for this issuer and relying-party context."
          },
          {
            "identity": "identity-assertion-to-oor-ecr",
            "map": "credential issuee AID",
            "comment": "Map only when this is the same AID used as the credential issuee; the AID is the credential subject binding, not a personLegalName attribute."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.value"
          }
        ]
      },
      {
        "id": "identity-assertion.masterIdentifier.system",
        "path": "identity-assertion.masterIdentifier.system",
        "short": "The system of the master identifier",
        "definition": "The system of the master identifier",
        "min": 1,
        "max": "1",
        "base": {
          "path": "identity-assertion.masterIdentifier.system",
          "min": 1,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.system"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.system"
          }
        ]
      },
      {
        "id": "identity-assertion.names",
        "path": "identity-assertion.names",
        "short": "The person's names",
        "definition": "The person's names",
        "min": 1,
        "max": "*",
        "base": {
          "path": "identity-assertion.names",
          "min": 1,
          "max": "*"
        },
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name"
          },
          {
            "identity": "identity-assertion-to-oor-ecr",
            "map": "personLegalName",
            "comment": "Use the current legal name; the credential attribute is a single full-name string, not separate given and family name fields."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name"
          }
        ]
      },
      {
        "id": "identity-assertion.names.id",
        "path": "identity-assertion.names.id",
        "representation": [
          "xmlAttr"
        ],
        "short": "Unique id for inter-element referencing",
        "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Element.id",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "extension": [
              {
                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                "valueUrl": "string"
              }
            ],
            "code": "http://hl7.org/fhirpath/System.String"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.names.extension",
        "path": "identity-assertion.names.extension",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            }
          ],
          "description": "Extensions are always sliced by (at least) url",
          "rules": "open"
        },
        "short": "Additional content defined by implementations",
        "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "alias": [
          "extensions",
          "user content"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "Element.extension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.names.modifierExtension",
        "path": "identity-assertion.names.modifierExtension",
        "short": "Extensions that cannot be ignored even if unrecognized",
        "definition": "May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "requirements": "Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).",
        "alias": [
          "extensions",
          "user content",
          "modifiers"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "BackboneElement.modifierExtension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": true,
        "isModifierReason": "Modifier extensions are expected to modify the meaning or interpretation of the element that contains them",
        "isSummary": true,
        "mapping": [
          {
            "identity": "rim",
            "map": "N/A"
          }
        ]
      },
      {
        "id": "identity-assertion.names.first",
        "path": "identity-assertion.names.first",
        "short": "The first name",
        "definition": "The first name",
        "min": 1,
        "max": "1",
        "base": {
          "path": "identity-assertion.names.first",
          "min": 1,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name.given",
            "comment": "Map as a given name."
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.given_name"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name.given",
            "comment": "Map as a given name."
          }
        ]
      },
      {
        "id": "identity-assertion.names.middle",
        "path": "identity-assertion.names.middle",
        "short": "The middle names",
        "definition": "The middle names",
        "min": 0,
        "max": "*",
        "base": {
          "path": "identity-assertion.names.middle",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name.given",
            "comment": "Map additional given names in order."
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.middle_name"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name.given",
            "comment": "Map additional given names in order."
          }
        ]
      },
      {
        "id": "identity-assertion.names.last",
        "path": "identity-assertion.names.last",
        "short": "The last name",
        "definition": "The last name",
        "min": 1,
        "max": "1",
        "base": {
          "path": "identity-assertion.names.last",
          "min": 1,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name.family"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.family_name"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name.family"
          }
        ]
      },
      {
        "id": "identity-assertion.names.prefix",
        "path": "identity-assertion.names.prefix",
        "short": "The prefix",
        "definition": "The prefix",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.names.prefix",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name.prefix"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name.prefix"
          }
        ]
      },
      {
        "id": "identity-assertion.names.suffix",
        "path": "identity-assertion.names.suffix",
        "short": "The suffix",
        "definition": "The suffix",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.names.suffix",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name.suffix"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name.suffix"
          }
        ]
      },
      {
        "id": "identity-assertion.names.validityPeriod",
        "path": "identity-assertion.names.validityPeriod",
        "short": "The validity of this name",
        "definition": "The validity of this name",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.names.validityPeriod",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "Period"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name.period"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name.period"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses",
        "path": "identity-assertion.addresses",
        "short": "Physical addresses",
        "definition": "Physical addresses",
        "min": 0,
        "max": "*",
        "base": {
          "path": "identity-assertion.addresses",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Address"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.address",
            "comment": "OIDC models one address object; select the applicable current address."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.id",
        "path": "identity-assertion.addresses.id",
        "representation": [
          "xmlAttr"
        ],
        "short": "Unique id for inter-element referencing",
        "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Element.id",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "extension": [
              {
                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                "valueUrl": "string"
              }
            ],
            "code": "http://hl7.org/fhirpath/System.String"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.extension",
        "path": "identity-assertion.addresses.extension",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            }
          ],
          "description": "Extensions are always sliced by (at least) url",
          "rules": "open"
        },
        "short": "Additional content defined by implementations",
        "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "alias": [
          "extensions",
          "user content"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "Element.extension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.use",
        "path": "identity-assertion.addresses.use",
        "short": "home | work | temp | old | billing",
        "definition": "home | work | temp | old | billing",
        "comment": "Applications can assume that an address is current unless it explicitly says that it is temporary or old.",
        "requirements": "Allows an appropriate address to be chosen from a list of many.",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Address.use",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "example": [
          {
            "label": "General",
            "valueCode": "home"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "isModifier": true,
        "isModifierReason": "This is labeled as \"Is Modifier\" because applications should not mistake a temporary or old address etc.for a current/permanent one",
        "isSummary": true,
        "binding": {
          "extension": [
            {
              "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
              "valueString": "AddressUse"
            }
          ],
          "strength": "required",
          "description": "The use of an address.",
          "valueSet": "http://hl7.org/fhir/ValueSet/address-use|4.0.1"
        },
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.use"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.use"
          },
          {
            "identity": "v2",
            "map": "XAD.7"
          },
          {
            "identity": "rim",
            "map": "unique(./use)"
          },
          {
            "identity": "servd",
            "map": "./AddressPurpose"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.type",
        "path": "identity-assertion.addresses.type",
        "short": "postal | physical | both",
        "definition": "postal | physical | both",
        "comment": "The definition of Address states that \"address is intended to describe postal addresses, not physical locations\". However, many applications track whether an address has a dual purpose of being a location that can be visited as well as being a valid delivery destination, and Postal addresses are often used as proxies for physical locations (also see the [Location](http://hl7.org/fhir/R4/location.html#) resource).",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Address.type",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "example": [
          {
            "label": "General",
            "valueCode": "both"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "isModifier": false,
        "isSummary": true,
        "binding": {
          "extension": [
            {
              "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
              "valueString": "AddressType"
            }
          ],
          "strength": "required",
          "description": "The type of an address (physical / postal).",
          "valueSet": "http://hl7.org/fhir/ValueSet/address-type|4.0.1"
        },
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.type"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.type"
          },
          {
            "identity": "v2",
            "map": "XAD.18"
          },
          {
            "identity": "rim",
            "map": "unique(./use)"
          },
          {
            "identity": "vcard",
            "map": "address type parameter"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.text",
        "path": "identity-assertion.addresses.text",
        "short": "Text representation of the address",
        "definition": "Specifies the entire address as it should be displayed e.g. on a postal label. This may be provided instead of or as well as the specific parts.",
        "comment": "Can provide both a text representation and parts. Applications updating an address SHALL ensure that  when both text and parts are present,  no content is included in the text that isn't found in a part.",
        "requirements": "A renderable, unencoded form.",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Address.text",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "example": [
          {
            "label": "General",
            "valueString": "137 Nowhere Street, Erewhon 9132"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "isModifier": false,
        "isSummary": true,
        "mapping": [
          {
            "identity": "v2",
            "map": "XAD.1 + XAD.2 + XAD.3 + XAD.4 + XAD.5 + XAD.6"
          },
          {
            "identity": "rim",
            "map": "./formatted"
          },
          {
            "identity": "vcard",
            "map": "address label parameter"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.line",
        "path": "identity-assertion.addresses.line",
        "short": "The street address",
        "definition": "The street address",
        "min": 0,
        "max": "*",
        "base": {
          "path": "Address.line",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "orderMeaning": "The order in which lines should appear in an address label",
        "example": [
          {
            "label": "General",
            "valueString": "137 Nowhere Street"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "isModifier": false,
        "isSummary": true,
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.line"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.address.street_address"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.line"
          },
          {
            "identity": "v2",
            "map": "XAD.1 + XAD.2 (note: XAD.1 and XAD.2 have different meanings for a company address than for a person address)"
          },
          {
            "identity": "rim",
            "map": "AD.part[parttype = AL]"
          },
          {
            "identity": "vcard",
            "map": "street"
          },
          {
            "identity": "servd",
            "map": "./StreetAddress (newline delimitted)"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.city",
        "path": "identity-assertion.addresses.city",
        "short": "The city of the address",
        "definition": "The city of the address",
        "alias": [
          "Municpality"
        ],
        "min": 1,
        "max": "1",
        "base": {
          "path": "Address.city",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "example": [
          {
            "label": "General",
            "valueString": "Erewhon"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "isModifier": false,
        "isSummary": true,
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.city"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.address.locality"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.city"
          },
          {
            "identity": "v2",
            "map": "XAD.3"
          },
          {
            "identity": "rim",
            "map": "AD.part[parttype = CTY]"
          },
          {
            "identity": "vcard",
            "map": "locality"
          },
          {
            "identity": "servd",
            "map": "./Jurisdiction"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.district",
        "path": "identity-assertion.addresses.district",
        "short": "District name (aka county)",
        "definition": "The name of the administrative area (county).",
        "comment": "District is sometimes known as county, but in some regions 'county' is used in place of city (municipality), so county name should be conveyed in city instead.",
        "alias": [
          "County"
        ],
        "min": 0,
        "max": "1",
        "base": {
          "path": "Address.district",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "example": [
          {
            "label": "General",
            "valueString": "Madison"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "isModifier": false,
        "isSummary": true,
        "mapping": [
          {
            "identity": "v2",
            "map": "XAD.9"
          },
          {
            "identity": "rim",
            "map": "AD.part[parttype = CNT | CPA]"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.state",
        "path": "identity-assertion.addresses.state",
        "short": "The state of the address",
        "definition": "The state of the address",
        "alias": [
          "Province",
          "Territory"
        ],
        "min": 1,
        "max": "1",
        "base": {
          "path": "Address.state",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "isModifier": false,
        "isSummary": true,
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.state"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.address.region"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.state"
          },
          {
            "identity": "v2",
            "map": "XAD.4"
          },
          {
            "identity": "rim",
            "map": "AD.part[parttype = STA]"
          },
          {
            "identity": "vcard",
            "map": "region"
          },
          {
            "identity": "servd",
            "map": "./Region"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.postalCode",
        "path": "identity-assertion.addresses.postalCode",
        "short": "The postal code",
        "definition": "The postal code",
        "alias": [
          "Zip"
        ],
        "min": 0,
        "max": "1",
        "base": {
          "path": "Address.postalCode",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "example": [
          {
            "label": "General",
            "valueString": "9132"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "isModifier": false,
        "isSummary": true,
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.postalCode"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.address.postal_code"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.postalCode"
          },
          {
            "identity": "v2",
            "map": "XAD.5"
          },
          {
            "identity": "rim",
            "map": "AD.part[parttype = ZIP]"
          },
          {
            "identity": "vcard",
            "map": "code"
          },
          {
            "identity": "servd",
            "map": "./PostalIdentificationCode"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.country",
        "path": "identity-assertion.addresses.country",
        "short": "The country of the address",
        "definition": "The country of the address",
        "comment": "ISO 3166 3 letter codes can be used in place of a human readable country name.",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Address.country",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "isModifier": false,
        "isSummary": true,
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.country"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.address.country"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.country"
          },
          {
            "identity": "v2",
            "map": "XAD.6"
          },
          {
            "identity": "rim",
            "map": "AD.part[parttype = CNT]"
          },
          {
            "identity": "vcard",
            "map": "country"
          },
          {
            "identity": "servd",
            "map": "./Country"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.period",
        "path": "identity-assertion.addresses.period",
        "short": "The validity of this address",
        "definition": "The validity of this address",
        "requirements": "Allows addresses to be placed in historical context.",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Address.period",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "Period"
          }
        ],
        "example": [
          {
            "label": "General",
            "valuePeriod": {
              "start": "2010-03-23",
              "end": "2010-07-01"
            }
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "isModifier": false,
        "isSummary": true,
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.period"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.period"
          },
          {
            "identity": "v2",
            "map": "XAD.12 / XAD.13 + XAD.14"
          },
          {
            "identity": "rim",
            "map": "./usablePeriod[type=\"IVL<TS>\"]"
          },
          {
            "identity": "servd",
            "map": "./StartDate and ./EndDate"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers",
        "path": "identity-assertion.phoneNumbers",
        "short": "Phone numbers",
        "definition": "Phone numbers",
        "min": 0,
        "max": "*",
        "base": {
          "path": "identity-assertion.phoneNumbers",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers.id",
        "path": "identity-assertion.phoneNumbers.id",
        "representation": [
          "xmlAttr"
        ],
        "short": "Unique id for inter-element referencing",
        "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Element.id",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "extension": [
              {
                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                "valueUrl": "string"
              }
            ],
            "code": "http://hl7.org/fhirpath/System.String"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers.extension",
        "path": "identity-assertion.phoneNumbers.extension",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            }
          ],
          "description": "Extensions are always sliced by (at least) url",
          "rules": "open"
        },
        "short": "Additional content defined by implementations",
        "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "alias": [
          "extensions",
          "user content"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "Element.extension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers.modifierExtension",
        "path": "identity-assertion.phoneNumbers.modifierExtension",
        "short": "Extensions that cannot be ignored even if unrecognized",
        "definition": "May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "requirements": "Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).",
        "alias": [
          "extensions",
          "user content",
          "modifiers"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "BackboneElement.modifierExtension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": true,
        "isModifierReason": "Modifier extensions are expected to modify the meaning or interpretation of the element that contains them",
        "isSummary": true,
        "mapping": [
          {
            "identity": "rim",
            "map": "N/A"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers.number",
        "path": "identity-assertion.phoneNumbers.number",
        "short": "The phone number",
        "definition": "The phone number",
        "min": 1,
        "max": "1",
        "base": {
          "path": "identity-assertion.phoneNumbers.number",
          "min": 1,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.value"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.phone_number",
            "comment": "OIDC models one phone_number claim; select the applicable current number."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.value"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers.validityPeriod",
        "path": "identity-assertion.phoneNumbers.validityPeriod",
        "short": "The validity of this number",
        "definition": "The validity of this number",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.phoneNumbers.validityPeriod",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "Period"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.period"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.period"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers.type",
        "path": "identity-assertion.phoneNumbers.type",
        "short": "phone | fax | pager | url | sms | other",
        "definition": "phone | fax | pager | url | sms | other",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.phoneNumbers.type",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.system"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.system"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers.use",
        "path": "identity-assertion.phoneNumbers.use",
        "short": "home | work | temp | old | mobile",
        "definition": "home | work | temp | old | mobile",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.phoneNumbers.use",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.use"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.use"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers.rank",
        "path": "identity-assertion.phoneNumbers.rank",
        "short": "Specify preferred order of use (1 = highest)",
        "definition": "Specify preferred order of use (1 = highest)",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.phoneNumbers.rank",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "integer"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.rank"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.rank"
          }
        ]
      },
      {
        "id": "identity-assertion.emails",
        "path": "identity-assertion.emails",
        "short": "Email addresses or direct messaging",
        "definition": "Email addresses or direct messaging",
        "min": 0,
        "max": "*",
        "base": {
          "path": "identity-assertion.emails",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom"
          }
        ]
      },
      {
        "id": "identity-assertion.emails.id",
        "path": "identity-assertion.emails.id",
        "representation": [
          "xmlAttr"
        ],
        "short": "Unique id for inter-element referencing",
        "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Element.id",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "extension": [
              {
                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                "valueUrl": "string"
              }
            ],
            "code": "http://hl7.org/fhirpath/System.String"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.emails.extension",
        "path": "identity-assertion.emails.extension",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            }
          ],
          "description": "Extensions are always sliced by (at least) url",
          "rules": "open"
        },
        "short": "Additional content defined by implementations",
        "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "alias": [
          "extensions",
          "user content"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "Element.extension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.emails.modifierExtension",
        "path": "identity-assertion.emails.modifierExtension",
        "short": "Extensions that cannot be ignored even if unrecognized",
        "definition": "May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "requirements": "Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).",
        "alias": [
          "extensions",
          "user content",
          "modifiers"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "BackboneElement.modifierExtension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": true,
        "isModifierReason": "Modifier extensions are expected to modify the meaning or interpretation of the element that contains them",
        "isSummary": true,
        "mapping": [
          {
            "identity": "rim",
            "map": "N/A"
          }
        ]
      },
      {
        "id": "identity-assertion.emails.address",
        "path": "identity-assertion.emails.address",
        "short": "The email address",
        "definition": "The email address",
        "min": 1,
        "max": "1",
        "base": {
          "path": "identity-assertion.emails.address",
          "min": 1,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.value"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.email",
            "comment": "OIDC models one email claim; select the applicable current address."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.value"
          }
        ]
      },
      {
        "id": "identity-assertion.emails.validityPeriod",
        "path": "identity-assertion.emails.validityPeriod",
        "short": "The validity of this email",
        "definition": "The validity of this email",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.emails.validityPeriod",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "Period"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.period"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.period"
          }
        ]
      },
      {
        "id": "identity-assertion.emails.type",
        "path": "identity-assertion.emails.type",
        "short": "work | personal",
        "definition": "work | personal",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.emails.type",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.use",
            "comment": "The personal code requires interpretation, such as mapping to home."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.use",
            "comment": "The personal code requires interpretation, such as mapping to home."
          }
        ]
      },
      {
        "id": "identity-assertion.ssn",
        "path": "identity-assertion.ssn",
        "short": "The social security number",
        "definition": "The social security number",
        "min": 0,
        "max": "*",
        "base": {
          "path": "identity-assertion.ssn",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.value",
            "comment": "Represent each value as an identifier and supply an appropriate system and type."
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.verified_claims.claims.ssn_last4",
            "comment": "Only derive and disclose the last four digits when authorized; never map the full SSN. This is a proposal-specific claim, not a standard OIDC claim."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.value",
            "comment": "Represent each value as an identifier and supply an appropriate system and type."
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers",
        "path": "identity-assertion.identifiers",
        "short": "Correlated external Identifiers",
        "definition": "Correlated external Identifiers",
        "min": 0,
        "max": "*",
        "base": {
          "path": "identity-assertion.identifiers",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier"
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers.id",
        "path": "identity-assertion.identifiers.id",
        "representation": [
          "xmlAttr"
        ],
        "short": "Unique id for inter-element referencing",
        "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Element.id",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "extension": [
              {
                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                "valueUrl": "string"
              }
            ],
            "code": "http://hl7.org/fhirpath/System.String"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers.extension",
        "path": "identity-assertion.identifiers.extension",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            }
          ],
          "description": "Extensions are always sliced by (at least) url",
          "rules": "open"
        },
        "short": "Additional content defined by implementations",
        "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "alias": [
          "extensions",
          "user content"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "Element.extension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers.modifierExtension",
        "path": "identity-assertion.identifiers.modifierExtension",
        "short": "Extensions that cannot be ignored even if unrecognized",
        "definition": "May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "requirements": "Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).",
        "alias": [
          "extensions",
          "user content",
          "modifiers"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "BackboneElement.modifierExtension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": true,
        "isModifierReason": "Modifier extensions are expected to modify the meaning or interpretation of the element that contains them",
        "isSummary": true,
        "mapping": [
          {
            "identity": "rim",
            "map": "N/A"
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers.value",
        "path": "identity-assertion.identifiers.value",
        "short": "The identifier value",
        "definition": "The identifier value",
        "min": 1,
        "max": "1",
        "base": {
          "path": "identity-assertion.identifiers.value",
          "min": 1,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.value"
          },
          {
            "identity": "identity-assertion-to-oor-ecr",
            "map": "LEI",
            "comment": "Map only when this identifier is the represented organization's LEI, not an identifier of the individual."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.value"
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers.system",
        "path": "identity-assertion.identifiers.system",
        "short": "The identifier system URL",
        "definition": "The identifier system URL",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.identifiers.system",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.system"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.system"
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers.type",
        "path": "identity-assertion.identifiers.type",
        "short": "The identifier type",
        "definition": "The identifier type",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.identifiers.type",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.type"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.type"
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers.validityPeriod",
        "path": "identity-assertion.identifiers.validityPeriod",
        "short": "The validity of this identifier",
        "definition": "The validity of this identifier",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.identifiers.validityPeriod",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "Period"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.period"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.period"
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers.issuer",
        "path": "identity-assertion.identifiers.issuer",
        "short": "The issuer of this identifier",
        "definition": "The issuer of this identifier",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.identifiers.issuer",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.assigner.display",
            "comment": "Convert the issuer string to an Identifier.assigner reference when possible."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.assigner.display",
            "comment": "Convert the issuer string to an Identifier.assigner reference when possible."
          }
        ]
      },
      {
        "id": "identity-assertion.birthDate",
        "path": "identity-assertion.birthDate",
        "short": "The birth date",
        "definition": "The birth date",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.birthDate",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "date"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.birthDate"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.birthdate"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.birthDate"
          }
        ]
      },
      {
        "id": "identity-assertion.photo",
        "path": "identity-assertion.photo",
        "short": "The person's photo",
        "definition": "The person's photo",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.photo",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "Attachment"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.photo"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.picture",
            "comment": "Convert to a retrievable image URL when available."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.photo"
          }
        ]
      },
      {
        "id": "identity-assertion.gender",
        "path": "identity-assertion.gender",
        "short": "male | female | other | unknown",
        "definition": "male | female | other | unknown",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.gender",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.gender"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.gender"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.gender"
          }
        ]
      },
      {
        "id": "identity-assertion.maritalStatus",
        "path": "identity-assertion.maritalStatus",
        "short": "unmarried | married | annulled | divorced",
        "definition": "unmarried | married | annulled | divorced",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.maritalStatus",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.maritalStatus"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.maritalStatus"
          }
        ]
      },
      {
        "id": "identity-assertion.race",
        "path": "identity-assertion.race",
        "short": "Asked but unknown | Asked but declined | unknown | American Indian | Asian | Black | Native Hawaiian | White | Other",
        "definition": "Asked but unknown | Asked but declined | unknown | American Indian | Asian | Black | Native Hawaiian | White | Other",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.race",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-race]"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-race]"
          }
        ]
      },
      {
        "id": "identity-assertion.ethnicity",
        "path": "identity-assertion.ethnicity",
        "short": "The ethnicity of the person",
        "definition": "The ethnicity of the person",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.ethnicity",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity]"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity]"
          }
        ]
      },
      {
        "id": "identity-assertion.tribalAffiliation",
        "path": "identity-assertion.tribalAffiliation",
        "short": "Tribal affiliation",
        "definition": "Tribal affiliation",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.tribalAffiliation",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "identity-assertion.religion",
        "path": "identity-assertion.religion",
        "short": "The religion of the person",
        "definition": "The religion of the person",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.religion",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "identity-assertion.placeOfBirth",
        "path": "identity-assertion.placeOfBirth",
        "short": "The place of birth",
        "definition": "The place of birth",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.placeOfBirth",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.extension[http://hl7.org/fhir/StructureDefinition/patient-birthPlace]",
            "comment": "Convert the string to the extension's valueAddress."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.extension[http://hl7.org/fhir/StructureDefinition/patient-birthPlace]",
            "comment": "Convert the string to the extension's valueAddress."
          }
        ]
      },
      {
        "id": "identity-assertion.placeOfDeath",
        "path": "identity-assertion.placeOfDeath",
        "short": "The place of death",
        "definition": "The place of death",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.placeOfDeath",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ]
      },
      {
        "id": "identity-assertion.deathDate",
        "path": "identity-assertion.deathDate",
        "short": "The date of death",
        "definition": "The date of death",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.deathDate",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "date"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.deceasedDateTime"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.deceasedDateTime"
          }
        ]
      },
      {
        "id": "identity-assertion.causeOfDeath",
        "path": "identity-assertion.causeOfDeath",
        "short": "The cause of death",
        "definition": "The cause of death",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.causeOfDeath",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "identity-assertion.assuranceLevel",
        "path": "identity-assertion.assuranceLevel",
        "short": "The level of assurance",
        "definition": "The level of assurance",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.assuranceLevel",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.verified_claims.verification.assurance_level",
            "comment": "Map to the OIDC4IDA verification assurance level."
          }
        ]
      },
      {
        "id": "identity-assertion.verificationStatus",
        "path": "identity-assertion.verificationStatus",
        "short": "The verification status",
        "definition": "The verification status",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.verificationStatus",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "identity-assertion.assuranceDate",
        "path": "identity-assertion.assuranceDate",
        "short": "The date of assurance",
        "definition": "The date of assurance",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.assuranceDate",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "date"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.verified_claims.verification.time",
            "comment": "Map to the time of identity verification."
          }
        ]
      },
      {
        "id": "identity-assertion.assuranceMethod",
        "path": "identity-assertion.assuranceMethod",
        "short": "The method of assurance",
        "definition": "The method of assurance",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.assuranceMethod",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "identity-assertion.contact",
        "path": "identity-assertion.contact",
        "short": "Emergency contacts",
        "definition": "Emergency contacts",
        "min": 0,
        "max": "*",
        "base": {
          "path": "identity-assertion.contact",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact"
          }
        ]
      },
      {
        "id": "identity-assertion.contact.id",
        "path": "identity-assertion.contact.id",
        "representation": [
          "xmlAttr"
        ],
        "short": "Unique id for inter-element referencing",
        "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Element.id",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "extension": [
              {
                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                "valueUrl": "string"
              }
            ],
            "code": "http://hl7.org/fhirpath/System.String"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.contact.extension",
        "path": "identity-assertion.contact.extension",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            }
          ],
          "description": "Extensions are always sliced by (at least) url",
          "rules": "open"
        },
        "short": "Additional content defined by implementations",
        "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "alias": [
          "extensions",
          "user content"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "Element.extension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.contact.modifierExtension",
        "path": "identity-assertion.contact.modifierExtension",
        "short": "Extensions that cannot be ignored even if unrecognized",
        "definition": "May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "requirements": "Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).",
        "alias": [
          "extensions",
          "user content",
          "modifiers"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "BackboneElement.modifierExtension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": true,
        "isModifierReason": "Modifier extensions are expected to modify the meaning or interpretation of the element that contains them",
        "isSummary": true,
        "mapping": [
          {
            "identity": "rim",
            "map": "N/A"
          }
        ]
      },
      {
        "id": "identity-assertion.contact.relationship",
        "path": "identity-assertion.contact.relationship",
        "short": "Relationship to the person",
        "definition": "Relationship to the person",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.contact.relationship",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.relationship"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.relationship"
          }
        ]
      },
      {
        "id": "identity-assertion.contact.name",
        "path": "identity-assertion.contact.name",
        "short": "Name of contact",
        "definition": "Name of contact",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.contact.name",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.name.text"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.name.text"
          }
        ]
      },
      {
        "id": "identity-assertion.contact.phone",
        "path": "identity-assertion.contact.phone",
        "short": "Phone of contact",
        "definition": "Phone of contact",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.contact.phone",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.telecom.value",
            "comment": "Set ContactPoint.system to phone."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.telecom.value",
            "comment": "Set ContactPoint.system to phone."
          }
        ]
      },
      {
        "id": "identity-assertion.contact.email",
        "path": "identity-assertion.contact.email",
        "short": "Email of contact",
        "definition": "Email of contact",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.contact.email",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.telecom.value",
            "comment": "Set ContactPoint.system to email."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.telecom.value",
            "comment": "Set ContactPoint.system to email."
          }
        ]
      },
      {
        "id": "identity-assertion.contact.address",
        "path": "identity-assertion.contact.address",
        "short": "Address of contact",
        "definition": "Address of contact",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.contact.address",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.address.text"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.address.text"
          }
        ]
      },
      {
        "id": "identity-assertion.contact.gender",
        "path": "identity-assertion.contact.gender",
        "short": "Gender of contact",
        "definition": "Gender of contact",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.contact.gender",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.gender"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.gender"
          }
        ]
      },
      {
        "id": "identity-assertion.contact.period",
        "path": "identity-assertion.contact.period",
        "short": "Contact period",
        "definition": "Contact period",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.contact.period",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "Period"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.period"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.period"
          }
        ]
      },
      {
        "id": "identity-assertion.communication",
        "path": "identity-assertion.communication",
        "short": "Languages spoken",
        "definition": "Languages spoken",
        "min": 0,
        "max": "*",
        "base": {
          "path": "identity-assertion.communication",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.communication"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.communication"
          }
        ]
      },
      {
        "id": "identity-assertion.communication.id",
        "path": "identity-assertion.communication.id",
        "representation": [
          "xmlAttr"
        ],
        "short": "Unique id for inter-element referencing",
        "definition": "Unique id for the element within a resource (for internal references). This may be any string value that does not contain spaces.",
        "min": 0,
        "max": "1",
        "base": {
          "path": "Element.id",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "extension": [
              {
                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fhir-type",
                "valueUrl": "string"
              }
            ],
            "code": "http://hl7.org/fhirpath/System.String"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.communication.extension",
        "path": "identity-assertion.communication.extension",
        "slicing": {
          "discriminator": [
            {
              "type": "value",
              "path": "url"
            }
          ],
          "description": "Extensions are always sliced by (at least) url",
          "rules": "open"
        },
        "short": "Additional content defined by implementations",
        "definition": "May be used to represent additional information that is not part of the basic definition of the element. To make the use of extensions safe and manageable, there is a strict set of governance  applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension.",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "alias": [
          "extensions",
          "user content"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "Element.extension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": false,
        "isSummary": false,
        "mapping": [
          {
            "identity": "rim",
            "map": "n/a"
          }
        ]
      },
      {
        "id": "identity-assertion.communication.modifierExtension",
        "path": "identity-assertion.communication.modifierExtension",
        "short": "Extensions that cannot be ignored even if unrecognized",
        "definition": "May be used to represent additional information that is not part of the basic definition of the element and that modifies the understanding of the element in which it is contained and/or the understanding of the containing element's descendants. Usually modifier elements provide negation or qualification. To make the use of extensions safe and manageable, there is a strict set of governance applied to the definition and use of extensions. Though any implementer can define an extension, there is a set of requirements that SHALL be met as part of the definition of the extension. Applications processing a resource are required to check for modifier extensions.\n\nModifier extensions SHALL NOT change the meaning of any elements on Resource or DomainResource (including cannot change the meaning of modifierExtension itself).",
        "comment": "There can be no stigma associated with the use of extensions by any application, project, or standard - regardless of the institution or jurisdiction that uses or defines the extensions.  The use of extensions is what allows the FHIR specification to retain a core level of simplicity for everyone.",
        "requirements": "Modifier extensions allow for extensions that *cannot* be safely ignored to be clearly distinguished from the vast majority of extensions which can be safely ignored.  This promotes interoperability by eliminating the need for implementers to prohibit the presence of extensions. For further information, see the [definition of modifier extensions](http://hl7.org/fhir/R4/extensibility.html#modifierExtension).",
        "alias": [
          "extensions",
          "user content",
          "modifiers"
        ],
        "min": 0,
        "max": "*",
        "base": {
          "path": "BackboneElement.modifierExtension",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "Extension"
          }
        ],
        "constraint": [
          {
            "key": "ele-1",
            "severity": "error",
            "human": "All FHIR elements must have a @value or children",
            "expression": "hasValue() or (children().count() > id.count())",
            "xpath": "@value|f:*|h:div",
            "source": "http://hl7.org/fhir/StructureDefinition/Element"
          },
          {
            "key": "ext-1",
            "severity": "error",
            "human": "Must have either extensions or value[x], not both",
            "expression": "extension.exists() != value.exists()",
            "xpath": "exists(f:extension)!=exists(f:*[starts-with(local-name(.), \"value\")])",
            "source": "http://hl7.org/fhir/StructureDefinition/Extension"
          }
        ],
        "isModifier": true,
        "isModifierReason": "Modifier extensions are expected to modify the meaning or interpretation of the element that contains them",
        "isSummary": true,
        "mapping": [
          {
            "identity": "rim",
            "map": "N/A"
          }
        ]
      },
      {
        "id": "identity-assertion.communication.language",
        "path": "identity-assertion.communication.language",
        "short": "Language",
        "definition": "Language",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.communication.language",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.communication.language"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.communication.language"
          }
        ]
      },
      {
        "id": "identity-assertion.communication.preferred",
        "path": "identity-assertion.communication.preferred",
        "short": "Preferred language",
        "definition": "Preferred language",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.communication.preferred",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "boolean"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.communication.preferred"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.communication.preferred"
          }
        ]
      },
      {
        "id": "identity-assertion.generalPractitioner",
        "path": "identity-assertion.generalPractitioner",
        "short": "General practitioners",
        "definition": "General practitioners",
        "min": 0,
        "max": "*",
        "base": {
          "path": "identity-assertion.generalPractitioner",
          "min": 0,
          "max": "*"
        },
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.generalPractitioner"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.generalPractitioner"
          }
        ]
      },
      {
        "id": "identity-assertion.managingOrganization",
        "path": "identity-assertion.managingOrganization",
        "short": "Managing organization",
        "definition": "Managing organization",
        "min": 0,
        "max": "1",
        "base": {
          "path": "identity-assertion.managingOrganization",
          "min": 0,
          "max": "1"
        },
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.managingOrganization",
            "comment": "Convert the organization string to a Reference(Organization)."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.managingOrganization",
            "comment": "Convert the organization string to a Reference(Organization)."
          }
        ]
      }
    ]
  },
  "differential": {
    "element": [
      {
        "id": "identity-assertion",
        "path": "identity-assertion",
        "short": "Identity Assertion",
        "definition": "A representation of asserted identity information, including names, postal addresses, and phone numbers with their validity periods.\n\n- Informed by [TEFCA IAS SOP](https://rce.sequoiaproject.org/wp-content/uploads/2024/08/XP-Implementation-SOP-IAS.pdf)\n- Informed by FHIR [Patient resource](https://hl7.org/fhir/R4/patient.html)\n- Informed by US-Core [Patient Profile](https://build.fhir.org/ig/HL7/US-Core/StructureDefinition-us-core-patient.html)",
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken"
          },
          {
            "identity": "identity-assertion-to-oor-ecr",
            "map": "OOR/ECR credential attributes"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient"
          }
        ]
      },
      {
        "id": "identity-assertion.masterIdentifier",
        "path": "identity-assertion.masterIdentifier",
        "short": "The master identifier",
        "definition": "The master identifier",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier"
          }
        ]
      },
      {
        "id": "identity-assertion.masterIdentifier.system",
        "path": "identity-assertion.masterIdentifier.system",
        "short": "The system of the master identifier",
        "definition": "The system of the master identifier",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.system"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.system"
          }
        ]
      },
      {
        "id": "identity-assertion.masterIdentifier.value",
        "path": "identity-assertion.masterIdentifier.value",
        "short": "The identifier value",
        "definition": "The identifier value",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.value"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.sub",
            "comment": "Use only when this is the subject identifier assigned for this issuer and relying-party context."
          },
          {
            "identity": "identity-assertion-to-oor-ecr",
            "map": "credential issuee AID",
            "comment": "Map only when this is the same AID used as the credential issuee; the AID is the credential subject binding, not a personLegalName attribute."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.value"
          }
        ]
      },
      {
        "id": "identity-assertion.names",
        "path": "identity-assertion.names",
        "short": "The person's names",
        "definition": "The person's names",
        "min": 1,
        "max": "*",
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name"
          },
          {
            "identity": "identity-assertion-to-oor-ecr",
            "map": "personLegalName",
            "comment": "Use the current legal name; the credential attribute is a single full-name string, not separate given and family name fields."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name"
          }
        ]
      },
      {
        "id": "identity-assertion.names.first",
        "path": "identity-assertion.names.first",
        "short": "The first name",
        "definition": "The first name",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name.given",
            "comment": "Map as a given name."
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.given_name"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name.given",
            "comment": "Map as a given name."
          }
        ]
      },
      {
        "id": "identity-assertion.names.middle",
        "path": "identity-assertion.names.middle",
        "short": "The middle names",
        "definition": "The middle names",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name.given",
            "comment": "Map additional given names in order."
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.middle_name"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name.given",
            "comment": "Map additional given names in order."
          }
        ]
      },
      {
        "id": "identity-assertion.names.last",
        "path": "identity-assertion.names.last",
        "short": "The last name",
        "definition": "The last name",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name.family"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.family_name"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name.family"
          }
        ]
      },
      {
        "id": "identity-assertion.names.prefix",
        "path": "identity-assertion.names.prefix",
        "short": "The prefix",
        "definition": "The prefix",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name.prefix"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name.prefix"
          }
        ]
      },
      {
        "id": "identity-assertion.names.suffix",
        "path": "identity-assertion.names.suffix",
        "short": "The suffix",
        "definition": "The suffix",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name.suffix"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name.suffix"
          }
        ]
      },
      {
        "id": "identity-assertion.names.validityPeriod",
        "path": "identity-assertion.names.validityPeriod",
        "short": "The validity of this name",
        "definition": "The validity of this name",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Period"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.name.period"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.name.period"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses",
        "path": "identity-assertion.addresses",
        "short": "Physical addresses",
        "definition": "Physical addresses",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "Address"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.address",
            "comment": "OIDC models one address object; select the applicable current address."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.period",
        "path": "identity-assertion.addresses.period",
        "short": "The validity of this address",
        "definition": "The validity of this address",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Period"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.period"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.period"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.use",
        "path": "identity-assertion.addresses.use",
        "short": "home | work | temp | old | billing",
        "definition": "home | work | temp | old | billing",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.use"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.use"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.type",
        "path": "identity-assertion.addresses.type",
        "short": "postal | physical | both",
        "definition": "postal | physical | both",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.type"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.type"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.line",
        "path": "identity-assertion.addresses.line",
        "short": "The street address",
        "definition": "The street address",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.line"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.address.street_address"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.line"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.city",
        "path": "identity-assertion.addresses.city",
        "short": "The city of the address",
        "definition": "The city of the address",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.city"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.address.locality"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.city"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.state",
        "path": "identity-assertion.addresses.state",
        "short": "The state of the address",
        "definition": "The state of the address",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.state"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.address.region"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.state"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.postalCode",
        "path": "identity-assertion.addresses.postalCode",
        "short": "The postal code",
        "definition": "The postal code",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.postalCode"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.address.postal_code"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.postalCode"
          }
        ]
      },
      {
        "id": "identity-assertion.addresses.country",
        "path": "identity-assertion.addresses.country",
        "short": "The country of the address",
        "definition": "The country of the address",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.address.country"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.address.country"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.address.country"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers",
        "path": "identity-assertion.phoneNumbers",
        "short": "Phone numbers",
        "definition": "Phone numbers",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers.number",
        "path": "identity-assertion.phoneNumbers.number",
        "short": "The phone number",
        "definition": "The phone number",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.value"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.phone_number",
            "comment": "OIDC models one phone_number claim; select the applicable current number."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.value"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers.validityPeriod",
        "path": "identity-assertion.phoneNumbers.validityPeriod",
        "short": "The validity of this number",
        "definition": "The validity of this number",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Period"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.period"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.period"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers.type",
        "path": "identity-assertion.phoneNumbers.type",
        "short": "phone | fax | pager | url | sms | other",
        "definition": "phone | fax | pager | url | sms | other",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.system"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.system"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers.use",
        "path": "identity-assertion.phoneNumbers.use",
        "short": "home | work | temp | old | mobile",
        "definition": "home | work | temp | old | mobile",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.use"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.use"
          }
        ]
      },
      {
        "id": "identity-assertion.phoneNumbers.rank",
        "path": "identity-assertion.phoneNumbers.rank",
        "short": "Specify preferred order of use (1 = highest)",
        "definition": "Specify preferred order of use (1 = highest)",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "integer"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.rank"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.rank"
          }
        ]
      },
      {
        "id": "identity-assertion.emails",
        "path": "identity-assertion.emails",
        "short": "Email addresses or direct messaging",
        "definition": "Email addresses or direct messaging",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom"
          }
        ]
      },
      {
        "id": "identity-assertion.emails.address",
        "path": "identity-assertion.emails.address",
        "short": "The email address",
        "definition": "The email address",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.value"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.email",
            "comment": "OIDC models one email claim; select the applicable current address."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.value"
          }
        ]
      },
      {
        "id": "identity-assertion.emails.validityPeriod",
        "path": "identity-assertion.emails.validityPeriod",
        "short": "The validity of this email",
        "definition": "The validity of this email",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Period"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.period"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.period"
          }
        ]
      },
      {
        "id": "identity-assertion.emails.type",
        "path": "identity-assertion.emails.type",
        "short": "work | personal",
        "definition": "work | personal",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.telecom.use",
            "comment": "The personal code requires interpretation, such as mapping to home."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.telecom.use",
            "comment": "The personal code requires interpretation, such as mapping to home."
          }
        ]
      },
      {
        "id": "identity-assertion.ssn",
        "path": "identity-assertion.ssn",
        "short": "The social security number",
        "definition": "The social security number",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.value",
            "comment": "Represent each value as an identifier and supply an appropriate system and type."
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.verified_claims.claims.ssn_last4",
            "comment": "Only derive and disclose the last four digits when authorized; never map the full SSN. This is a proposal-specific claim, not a standard OIDC claim."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.value",
            "comment": "Represent each value as an identifier and supply an appropriate system and type."
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers",
        "path": "identity-assertion.identifiers",
        "short": "Correlated external Identifiers",
        "definition": "Correlated external Identifiers",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier"
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers.value",
        "path": "identity-assertion.identifiers.value",
        "short": "The identifier value",
        "definition": "The identifier value",
        "min": 1,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.value"
          },
          {
            "identity": "identity-assertion-to-oor-ecr",
            "map": "LEI",
            "comment": "Map only when this identifier is the represented organization's LEI, not an identifier of the individual."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.value"
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers.system",
        "path": "identity-assertion.identifiers.system",
        "short": "The identifier system URL",
        "definition": "The identifier system URL",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.system"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.system"
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers.type",
        "path": "identity-assertion.identifiers.type",
        "short": "The identifier type",
        "definition": "The identifier type",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.type"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.type"
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers.validityPeriod",
        "path": "identity-assertion.identifiers.validityPeriod",
        "short": "The validity of this identifier",
        "definition": "The validity of this identifier",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Period"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.period"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.period"
          }
        ]
      },
      {
        "id": "identity-assertion.identifiers.issuer",
        "path": "identity-assertion.identifiers.issuer",
        "short": "The issuer of this identifier",
        "definition": "The issuer of this identifier",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.identifier.assigner.display",
            "comment": "Convert the issuer string to an Identifier.assigner reference when possible."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.identifier.assigner.display",
            "comment": "Convert the issuer string to an Identifier.assigner reference when possible."
          }
        ]
      },
      {
        "id": "identity-assertion.birthDate",
        "path": "identity-assertion.birthDate",
        "short": "The birth date",
        "definition": "The birth date",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "date"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.birthDate"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.birthdate"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.birthDate"
          }
        ]
      },
      {
        "id": "identity-assertion.photo",
        "path": "identity-assertion.photo",
        "short": "The person's photo",
        "definition": "The person's photo",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Attachment"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.photo"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.picture",
            "comment": "Convert to a retrievable image URL when available."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.photo"
          }
        ]
      },
      {
        "id": "identity-assertion.gender",
        "path": "identity-assertion.gender",
        "short": "male | female | other | unknown",
        "definition": "male | female | other | unknown",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.gender"
          },
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.gender"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.gender"
          }
        ]
      },
      {
        "id": "identity-assertion.maritalStatus",
        "path": "identity-assertion.maritalStatus",
        "short": "unmarried | married | annulled | divorced",
        "definition": "unmarried | married | annulled | divorced",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.maritalStatus"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.maritalStatus"
          }
        ]
      },
      {
        "id": "identity-assertion.race",
        "path": "identity-assertion.race",
        "short": "Asked but unknown | Asked but declined | unknown | American Indian | Asian | Black | Native Hawaiian | White | Other",
        "definition": "Asked but unknown | Asked but declined | unknown | American Indian | Asian | Black | Native Hawaiian | White | Other",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-race]"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-race]"
          }
        ]
      },
      {
        "id": "identity-assertion.ethnicity",
        "path": "identity-assertion.ethnicity",
        "short": "The ethnicity of the person",
        "definition": "The ethnicity of the person",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity]"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.extension[http://hl7.org/fhir/us/core/StructureDefinition/us-core-ethnicity]"
          }
        ]
      },
      {
        "id": "identity-assertion.tribalAffiliation",
        "path": "identity-assertion.tribalAffiliation",
        "short": "Tribal affiliation",
        "definition": "Tribal affiliation",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "identity-assertion.religion",
        "path": "identity-assertion.religion",
        "short": "The religion of the person",
        "definition": "The religion of the person",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "identity-assertion.placeOfBirth",
        "path": "identity-assertion.placeOfBirth",
        "short": "The place of birth",
        "definition": "The place of birth",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.extension[http://hl7.org/fhir/StructureDefinition/patient-birthPlace]",
            "comment": "Convert the string to the extension's valueAddress."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.extension[http://hl7.org/fhir/StructureDefinition/patient-birthPlace]",
            "comment": "Convert the string to the extension's valueAddress."
          }
        ]
      },
      {
        "id": "identity-assertion.placeOfDeath",
        "path": "identity-assertion.placeOfDeath",
        "short": "The place of death",
        "definition": "The place of death",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ]
      },
      {
        "id": "identity-assertion.deathDate",
        "path": "identity-assertion.deathDate",
        "short": "The date of death",
        "definition": "The date of death",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "date"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.deceasedDateTime"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.deceasedDateTime"
          }
        ]
      },
      {
        "id": "identity-assertion.causeOfDeath",
        "path": "identity-assertion.causeOfDeath",
        "short": "The cause of death",
        "definition": "The cause of death",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "identity-assertion.assuranceLevel",
        "path": "identity-assertion.assuranceLevel",
        "short": "The level of assurance",
        "definition": "The level of assurance",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.verified_claims.verification.assurance_level",
            "comment": "Map to the OIDC4IDA verification assurance level."
          }
        ]
      },
      {
        "id": "identity-assertion.verificationStatus",
        "path": "identity-assertion.verificationStatus",
        "short": "The verification status",
        "definition": "The verification status",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "identity-assertion.assuranceDate",
        "path": "identity-assertion.assuranceDate",
        "short": "The date of assurance",
        "definition": "The date of assurance",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "date"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-oidc-token",
            "map": "OIDCToken.verified_claims.verification.time",
            "comment": "Map to the time of identity verification."
          }
        ]
      },
      {
        "id": "identity-assertion.assuranceMethod",
        "path": "identity-assertion.assuranceMethod",
        "short": "The method of assurance",
        "definition": "The method of assurance",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ]
      },
      {
        "id": "identity-assertion.contact",
        "path": "identity-assertion.contact",
        "short": "Emergency contacts",
        "definition": "Emergency contacts",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact"
          }
        ]
      },
      {
        "id": "identity-assertion.contact.relationship",
        "path": "identity-assertion.contact.relationship",
        "short": "Relationship to the person",
        "definition": "Relationship to the person",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.relationship"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.relationship"
          }
        ]
      },
      {
        "id": "identity-assertion.contact.name",
        "path": "identity-assertion.contact.name",
        "short": "Name of contact",
        "definition": "Name of contact",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.name.text"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.name.text"
          }
        ]
      },
      {
        "id": "identity-assertion.contact.phone",
        "path": "identity-assertion.contact.phone",
        "short": "Phone of contact",
        "definition": "Phone of contact",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.telecom.value",
            "comment": "Set ContactPoint.system to phone."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.telecom.value",
            "comment": "Set ContactPoint.system to phone."
          }
        ]
      },
      {
        "id": "identity-assertion.contact.email",
        "path": "identity-assertion.contact.email",
        "short": "Email of contact",
        "definition": "Email of contact",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.telecom.value",
            "comment": "Set ContactPoint.system to email."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.telecom.value",
            "comment": "Set ContactPoint.system to email."
          }
        ]
      },
      {
        "id": "identity-assertion.contact.address",
        "path": "identity-assertion.contact.address",
        "short": "Address of contact",
        "definition": "Address of contact",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.address.text"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.address.text"
          }
        ]
      },
      {
        "id": "identity-assertion.contact.gender",
        "path": "identity-assertion.contact.gender",
        "short": "Gender of contact",
        "definition": "Gender of contact",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.gender"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.gender"
          }
        ]
      },
      {
        "id": "identity-assertion.contact.period",
        "path": "identity-assertion.contact.period",
        "short": "Contact period",
        "definition": "Contact period",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "Period"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.contact.period"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.contact.period"
          }
        ]
      },
      {
        "id": "identity-assertion.communication",
        "path": "identity-assertion.communication",
        "short": "Languages spoken",
        "definition": "Languages spoken",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.communication"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.communication"
          }
        ]
      },
      {
        "id": "identity-assertion.communication.language",
        "path": "identity-assertion.communication.language",
        "short": "Language",
        "definition": "Language",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "code"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.communication.language"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.communication.language"
          }
        ]
      },
      {
        "id": "identity-assertion.communication.preferred",
        "path": "identity-assertion.communication.preferred",
        "short": "Preferred language",
        "definition": "Preferred language",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "boolean"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.communication.preferred"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.communication.preferred"
          }
        ]
      },
      {
        "id": "identity-assertion.generalPractitioner",
        "path": "identity-assertion.generalPractitioner",
        "short": "General practitioners",
        "definition": "General practitioners",
        "min": 0,
        "max": "*",
        "type": [
          {
            "code": "BackboneElement"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.generalPractitioner"
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.generalPractitioner"
          }
        ]
      },
      {
        "id": "identity-assertion.managingOrganization",
        "path": "identity-assertion.managingOrganization",
        "short": "Managing organization",
        "definition": "Managing organization",
        "min": 0,
        "max": "1",
        "type": [
          {
            "code": "string"
          }
        ],
        "mapping": [
          {
            "identity": "identity-assertion-to-patient",
            "map": "Patient.managingOrganization",
            "comment": "Convert the organization string to a Reference(Organization)."
          },
          {
            "identity": "identity-assertion-to-us-core-patient",
            "map": "Patient.managingOrganization",
            "comment": "Convert the organization string to a Reference(Organization)."
          }
        ]
      }
    ]
  }
}