Release 4

This page is part of the FHIR Specification (v4.0.1: R4 - Mixed Normative and STU) in it's permanent home (it will always be available at this URL). The current version which supercedes this version is 4.3.0. For a full list of available versions, see the Directory of published versions HL7 v3 Value Set hl7Realm

Vocabulary Work Group Maturity Level: N/AExternal Use Context: Any

This value set ( is defined as part of HL7 v3.


Defining URL:
Title:v3 Code System hl7Realm

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.

OID:2.16.840.1.113883.1.11.20355 (for OID based terminology systems)
Source ResourceXML / JSON

This value set is used in the following places:

  • CodeSystem: This value set is the designated 'entire code system' value set for v3.hl7Realm

This value set includes codes from the following code systems:


This expansion generated 01 Nov 2019

This value set contains 42 concepts

Expansion based on version 2018-08-12

All codes from system

0BindingRealmsbinding realmsDescription: Concepts that can be used as Binding Realms when creating Binding Statements. These codes are permitted to appear in the InfrastructureRoot.realmCode attribute.
1  AffiliateRealmsAffiliate RealmsDescription: 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.
2    ARArgentinaDescription: Realm code for use of Argentina
2    ATAustriaDescription: Realm code for use of Austria
2    AUAustraliaDescription: Realm code for use of Australia
2    BRBrazilDescription: Realm code for use of Brazil
2    CACanadaDescription: Realm code for use of Canada
2    CHSwitzerlandDescription: Realm code for use of Switzerland
2    CLChileDescription: Realm code for use of Chile
2    CNChinaDescription: Realm code for use of China
2    COColumbiaDescription: Realm code for use of Localized Version
2    CZCzech RepublicDescription: Realm code for use of Czech Republic
2    DEGermanyDescription: Realm code for use of Germany
2    DKDenmarkDescription: Realm code for use of Denmark
2    ESSpainDescription: Realm code for use of Spain
2    FIFinlandDescription: Realm code for use of Finland
2    FRFranceDescription: Realm code for use of France
2    GRGreeceDescription: Realm code for use of Greece
2    HRCroatiaDescription: Realm code for use of Croatia
2    IEIrelandDescription: Realm code for use of Ireland
2    INIndiaDescription: Realm code for use of India
2    ITItalyDescription: Realm code for use of Italy
2    JPJapanDescription: Realm code for use of Japan
2    KRKoreaDescription: Realm code for use of Korea
2    LTLithuaniaDescription: Realm code for use of Lithuania
2    MXMexicoDescription: Realm code for use of Mexico
2    NLThe NetherlandsDescription: Realm code for use of The Netherlands
2    NZNew ZealandDescription: Realm code for use of New Zealand
2    RORomaniaDescription: Realm code for use of Romania
2    RURussian FederationDescription: Realm code for use of Russian Federation
2    SESwedenDescription: Realm code for use of Sweden
2    SGSingaporeDescription: Realm code for use of Localized Version
2    SOASouthern AfricaDescription: Realm code for use of Southern Africa
2    TRTurkeyDescription: Realm code for use of Turkey
2    TWTaiwanDescription: Realm code for use of Taiwan
2    UKUnited KingdomDescription: Realm code for use of United Kingdom
2    USUnited States of AmericaDescription: Realm code for use of United States of America
2    UVUniversalDescription: Realm code for use of Universal realm or context, used in every instance
2    UYUruguayDescription: Realm code for use of Uruguay
1  C1Unclassified RealmDescription: Realm code for use of Unclassified Realm
1  GBGreat BritainDescription: Realm code for use of Great Britain
1  R1Representative RealmDescription: Realm code for use of Representative Realm
1  X1Example RealmDescription: Realm code for use of Example Realm
0NamespaceRealmsnamespace realmsDescription: Codes that can be used in the "realm" portion of HL7 v3 artifact identifiers.
1  ZZLocalized VersionDescription: 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.