HL7 Terminology (THO)
5.5.0 - Publication International flag

This page is part of the HL7 Terminology (v5.5.0: Release) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

CodeSystem: HL7Realm

Official URL: http://terminology.hl7.org/CodeSystem/v3-hl7Realm Version: 3.0.0
Active as of 2019-03-20 Responsible: Health Level Seven International Computable Name: Hl7Realm
Other Identifiers: urn:ietf:rfc:3986#Uniform Resource Identifier (URI)#urn:oid:2.16.840.1.113883.5.1124

Copyright/Legal: This material derives from the HL7 Terminology THO. THO is copyright ©1989+ Health Level Seven International and is made available under the CC0 designation. For more licensing information see: https://terminology.hl7.org/license

Description: Coded concepts representing Binding Realms (used for Context Binding of terminology in HL7 models) and/or Namespace Realms (used to help ensure unique identification of HL7 artifacts). This code system is partitioned into three sections: Affiliate realms, Binding realms and Namespace realms. All affiliate realm codes may automatically be used as both binding realms and namespace realms. Furthermore, affiliate realms are the only realms that have authority over the creation of binding realms. (Note that ‘affiliate’ includes the idea of both international affiliates and the HL7 International organization.) All other codes must be associated with an owning affiliate realm and must appear as a specialization of _BindingRealm or _NamespaceRealm. For affiliates whose concepts align with nations, the country codes from ISO 3166-1 2-character alpha are used for the code when possible so these codes should not be used for other realm types. It is recommended that binding realm and namespace codes submitted by affiliates use the realm code as a prefix to avoid possible collisions with ISO codes. However, tooling does not currently support namepace realm codes greater than 2 characters.

Open Issue: The name of the concept property “owningAffiliate” should be changed to better reflect that the property value is the human readable name of the organizational entity that manages the Realm identified by the Realm Code.

Open Issue: In spite of the inability of tooling to process codes longer than 2 characters, there is at least one realm codes (‘SOA’) that was added that is 3 characters in length.

This Code system is referenced in the content logical definition of the following value sets:


This code system defines the following properties for its concepts

SpecializesCodingThe child code is a more narrow version of the concept represented by the parent code. I.e. Every child concept is also a valid parent concept. Used to allow determination of subsumption. Must be transitive, irreflexive, antisymmetric.
GeneralizesCodingInverse of Specializes. Only included as a derived relationship.
OwningAffiliatehttp://terminology.hl7.org/CodeSystem/utg-concept-properties#OwningAffiliateCodingIdentifies the affiliate responsible for a binding realm or namespace realm code. Must be specified for all codes that are not specializations of AffiliateRealms. ConceptRelationshipProperties: [relationshipKind: other; isNavigable: false; functionalism: functional; reflexivity: irreflexive; symmetry: antisymetric; connected: false; transitivity: antitransitive; allowedForTargets: all codes from the hl7PublishingSection code system; requiredForSources: all codes which are not equal to ZZ and are not specializations of the abstract code AffiliateRealms; allowedForTargets: all codes which are specializations of the abstract code AffiliateRealms;]
internalIdhttp://terminology.hl7.org/CodeSystem/utg-concept-properties#v3-internal-idcodeThe internal identifier for the concept in the HL7 Access database repository.
statushttp://hl7.org/fhir/concept-properties#statuscodeDesignation of a concept's state. Normally is not populated unless the state is retired..
notSelectablehttp://hl7.org/fhir/concept-properties#notSelectablebooleanIndicates that the code is abstract - only intended to be used as a selector for other concepts
subsumedByhttp://hl7.org/fhir/concept-properties#parentcodeThe concept code of a parent concept


This case-sensitive code system http://terminology.hl7.org/CodeSystem/v3-hl7Realm defines the following codes in a Is-A heirarchy:

LvlCodeDisplayDefinitionHL7 Affiliate OwnerinternalIdstatusNot SelectableParent
1BindingRealms binding realms**Description:** Concepts that can be used as Binding Realms when creating Binding Statements. These codes are permitted to appear in the InfrastructureRoot.realmCode attribute.23214activetrue
2  AffiliateRealms Affiliate Realms**Description:** Realm codes for official HL7 organizational bodies. This includes both the HL7 International organization as well as all recognized international affiliates (past and present). These groups have the ability to bind vocabulary and develop artifacts. As well, they have the ability to have "ownership" over other binding realms and namespace realms via the owningAffiliate property of those other realm codes.22941activetrueBindingRealms, NamespaceRealms
3    AR Argentina**Description:** Realm code for use of Argentina22942activeAffiliateRealms
3    AT Austria**Description:** Realm code for use of Austria22943activeAffiliateRealms
3    AU Australia**Description:** Realm code for use of Australia22944activeAffiliateRealms
3    BR Brazil**Description:** Realm code for use of Brazil22945activeAffiliateRealms
3    CA Canada**Description:** Realm code for use of Canada22946activeAffiliateRealms
3    CH Switzerland**Description:** Realm code for use of Switzerland22947activeAffiliateRealms
3    CL Chile**Description:** Realm code for use of Chile22948activeAffiliateRealms
3    CN China**Description:** Realm code for use of China22949activeAffiliateRealms
3    CO Columbia**Description:** Realm code for use of Localized Version22977activeAffiliateRealms
3    CZ Czech Republic**Description:** Realm code for use of Czech Republic22950activeAffiliateRealms
3    DE Germany**Description:** Realm code for use of Germany22951activeAffiliateRealms
3    DK Denmark**Description:** Realm code for use of Denmark22952activeAffiliateRealms
3    ES Spain**Description:** Realm code for use of Spain22953activeAffiliateRealms
3    FI Finland**Description:** Realm code for use of Finland22954activeAffiliateRealms
3    FR France**Description:** Realm code for use of France22955activeAffiliateRealms
3    GR Greece**Description:** Realm code for use of Greece22956activeAffiliateRealms
3    HR Croatia**Description:** Realm code for use of Croatia22957activeAffiliateRealms
3    IE Ireland**Description:** Realm code for use of Ireland22958activeAffiliateRealms
3    IN India**Description:** Realm code for use of India22959activeAffiliateRealms
3    IT Italy**Description:** Realm code for use of Italy22960activeAffiliateRealms
3    JP Japan**Description:** Realm code for use of Japan22961activeAffiliateRealms
3    KR Korea**Description:** Realm code for use of Korea22962activeAffiliateRealms
3    LT Lithuania**Description:** Realm code for use of Lithuania22963activeAffiliateRealms
3    MX Mexico**Description:** Realm code for use of Mexico22964activeAffiliateRealms
3    NL The Netherlands**Description:** Realm code for use of The Netherlands22965activeAffiliateRealms
3    NZ New Zealand**Description:** Realm code for use of New Zealand22966activeAffiliateRealms
3    RO Romania**Description:** Realm code for use of Romania22967activeAffiliateRealms
3    RU Russian Federation**Description:** Realm code for use of Russian Federation22968activeAffiliateRealms
3    SE Sweden**Description:** Realm code for use of Sweden22969activeAffiliateRealms
3    SG Singapore**Description:** Realm code for use of Localized Version22978activeAffiliateRealms
3    SOA Southern Africa**Description:** Realm code for use of Southern Africa22970activeAffiliateRealms
3    TR Turkey**Description:** Realm code for use of Turkey22971activeAffiliateRealms
3    TW Taiwan**Description:** Realm code for use of Taiwan22972activeAffiliateRealms
3    UK United Kingdom**Description:** Realm code for use of United Kingdom22973activeAffiliateRealms
3    US United States of America**Description:** Realm code for use of United States of America22975activeAffiliateRealms
3    UV Universal**Description:** Realm code for use of Universal realm or context, used in every instance22939activeAffiliateRealms
3    UY Uruguay**Description:** Realm code for use of Uruguay22976activeAffiliateRealms
2  C1 Unclassified Realm**Description:** Realm code for use of Unclassified RealmUV22937activeBindingRealms
2  GB Great Britain**Description:** Realm code for use of Great BritainUK22974activeBindingRealms, NamespaceRealms
2  R1 Representative Realm**Description:** Realm code for use of Representative RealmUV22938activeBindingRealms
2  X1 Example Realm**Description:** Realm code for use of Example RealmUV22940activeBindingRealms
1NamespaceRealms namespace realms**Description:** Codes that can be used in the "realm" portion of HL7 v3 artifact identifiers.23215activetrue
2  ZZ Localized Version**Description:** An artifact created for local use only. This realm namespace has no owning affiliate. Its use is uncontrolled, i.e. anyone can create artifacts using this realm namespace. Because of this, there is a significant likelihood of artifact identifier collisions. Implementers are encouraged to register their artifacts under an affiliate owned and controlled namespace to avoid such collision problems where possible.22935activeNamespaceRealms
2  AffiliateRealmsAffiliate Realms
2  GBGreat Britain
1SpecialRealms Special Realms**Description:** Realm code for use of Special Realms22936retiredtrue


2023-11-14reviseTSMGMarc DuteauAdd standard copyright and contact to internal content; up-476
2022-10-18reviseTSMGMarc DuteauFixing missing metadata; up-349
2022-02-17 00:00:32+1100reviseVocabulary WGGrahame GrievePopulate Missing caseSensitive property; UP-286
2020-05-06reviseVocabulary WGTed KleinMigrated to the UTG maintenance environment and publishing tooling.