FHIR Extensions Pack
5.3.0-ballot - (September 2025 Ballot) International flag

This page is part of the FHIR Core Extensions Registry (v5.3.0-ballot: Release 5.3) based on FHIR (HL7® FHIR® Standard) v5.0.0. This version is a pre-release. The current official version is 5.2.0. For a full list of available versions, see the Directory of published versions

Extension: Patient Citizenship

Official URL: http://hl7.org/fhir/StructureDefinition/patient-citizenship Version: 5.3.0-ballot
Standards status: Trial-use Maturity Level: 3 Responsible: HL7 International / Patient Administration Computable Name: PatCitizenship
Other Identifiers: OID:2.16.840.1.113883.4.642.5.1330

The patient's legal status as citizen of a country.

Context of Use

This extension may be used on the following element(s)

Usage info

Usages:

  • This Extension is not used by any profiles in this Implementation Guide

You can also check for usages in the FHIR IG Statistics

Changes since version 5.2.0:

  • No changes

    • Formal Views of Extension Content

    Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

    This structure is derived from Extension

    Summary

    Complex Extension: The patient's legal status as citizen of a country.

    • code: CodeableConcept: Nation code representing the citizenship of patient.
    • period: Period: Period when citizenship was effective.

    Maturity: 3

    This structure is derived from Extension

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Extension 0..* Extension Nation(s) where the patient claims citizenship
    ... Slices for extension Content/Rules for all slices
    .... extension:code 0..1 Extension Nation code of citizenship
    ..... extension 0..0
    ..... url 1..1 uri "code"
    ..... value[x] 1..1 CodeableConcept Value of extension
    Binding: CountryValueSet (preferred)
    .... extension:period 0..1 Extension Time period of citizenship
    ..... extension 0..0
    ..... url 1..1 uri "period"
    ..... value[x] 1..1 Period Value of extension
    ... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/patient-citizenship"
    ... value[x] 0..0

    doco Documentation for this format
    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Extension 0..* Extension Nation(s) where the patient claims citizenship
    ... id 0..1 id Unique id for inter-element referencing
    ... Slices for extension 0..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    .... extension:code 0..1 Extension Nation code of citizenship
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "code"
    ..... value[x] 1..1 CodeableConcept Value of extension
    Binding: CountryValueSet (preferred)
    .... extension:period 0..1 Extension Time period of citizenship
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "period"
    ..... value[x] 1..1 Period Value of extension
    ... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/patient-citizenship"

    doco Documentation for this format

    This structure is derived from Extension

    Summary

    Complex Extension: The patient's legal status as citizen of a country.

    • code: CodeableConcept: Nation code representing the citizenship of patient.
    • period: Period: Period when citizenship was effective.

    Maturity: 3

    Differential View

    This structure is derived from Extension

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Extension 0..* Extension Nation(s) where the patient claims citizenship
    ... Slices for extension Content/Rules for all slices
    .... extension:code 0..1 Extension Nation code of citizenship
    ..... extension 0..0
    ..... url 1..1 uri "code"
    ..... value[x] 1..1 CodeableConcept Value of extension
    Binding: CountryValueSet (preferred)
    .... extension:period 0..1 Extension Time period of citizenship
    ..... extension 0..0
    ..... url 1..1 uri "period"
    ..... value[x] 1..1 Period Value of extension
    ... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/patient-citizenship"
    ... value[x] 0..0

    doco Documentation for this format

    Snapshot View

    NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
    .. Extension 0..* Extension Nation(s) where the patient claims citizenship
    ... id 0..1 id Unique id for inter-element referencing
    ... Slices for extension 0..* Extension Additional content defined by implementations
    Slice: Unordered, Open by value:url
    .... extension:code 0..1 Extension Nation code of citizenship
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "code"
    ..... value[x] 1..1 CodeableConcept Value of extension
    Binding: CountryValueSet (preferred)
    .... extension:period 0..1 Extension Time period of citizenship
    ..... id 0..1 id Unique id for inter-element referencing
    ..... extension 0..0
    ..... url 1..1 uri "period"
    ..... value[x] 1..1 Period Value of extension
    ... url 1..1 uri "http://hl7.org/fhir/StructureDefinition/patient-citizenship"

    doco Documentation for this format

     

    Other representations of profile: CSV, Excel, Schematron

    Terminology Bindings

    PathConformanceValueSetURI
    Extension.extension:code.value[x]preferredCountryValueSet
    http://hl7.org/fhir/ValueSet/country
    From the FHIR Standard

    Constraints

    IdGradePath(s)DetailsRequirements
    ele-1error**ALL** elementsAll FHIR elements must have a @value or children
    : hasValue() or (children().count() > id.count())
    ext-1error**ALL** extensionsMust have either extensions or value[x], not both
    : extension.exists() != value.exists()

    R4B

    The extension is unchanged in R4B

    R4

    The extension is unchanged in R4

    R3

    The extension is unchanged in R3

    Search Parameters for this Extension

    (none found)