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. For a full list of available versions, see the Directory of published versions

Using ICD with HL7 Standards

This page describes how to use ICD with HL7 Standards.

Using ICD with FHIR R5

ICD is a family of code systems maintained by WHO, with many countries publishing their own variants.

There are two principal revisions of ICD in use - ICD-10 and ICD-9 (note that while US usage has recently updated to ICD-10, there is still a lot of legacy data coded in ICD-9). Though these can be referred to as different versions of ICD, they are entirely distinct sets of codes, with significant differences in organization and coding rules. Plus, if period ('.') characters are disregarded (as occurs in some systems), a few of the codes are overlapping between ICD-9 and ICD-10. Given these considerations, ICD-9 and ICD-10 are represented as entirely separate code systems. The new version of the ICD (ICD-11) was released on June 18, 2018, as a preliminary version. It was officially presented at the World Health Assembly in May 2019 and will be used as the official reporting system by member states beginning January 1, 2022.


SourceWHO or see below(CDC)
Systemhttp://hl7.org/fhir/sid/icd-10 and
http://hl7.org/fhir/sid/icd-10-[x] (see below)
See ICD-9 Variants section below
OID2.16.840.1.113883.6.3See ICD-9 Variants section below
VersionThe versioning convention and frequency may vary between the various ICD revisions and variants. WHO publishes a new version of ICD-10 annually in October (with minor updates annually, and major updates, if required, every 3 years - the versions are identified as 'YYYY', e.g. '2016'). The national variants (which in some cases are used multi-nationally) are also typically published on an annual basis (refer to the documentation for a particular variant for details).
CodeEither an ICD-10 or ICD-9 code, or a dual (multiple) coding expression - see below. ICD codes SHALL be represented with the period included, e.g. 123.4
DisplayThere are no specific conventions required or described for obtaining the complete display string for use for each code.
InactiveICD-9 and ICD-10 do not have codes that are identified as inactive (although in some cases previously included codes may have been removed or changed in meaning in subsequent versions).
HierarchyThe tabular representations are organized with headings and multiple levels of codes (typically based on the numbers of digits contained in each code), corresponding to CodeSystem.hierarchyMeaning = 'classified-with'.
Filter PropertiesNone are described yet.

ICD-9 variants

ICD-9-CM is a clinical modification of the World Health Organization's International Classification of Diseases, 9th Revision (ICD-9). There is no url specified for ICD-9.


ICD-9-CM (clinical codes)http://hl7.org/fhir/sid/icd-9-cm2.16.840.1.113883.6.103
ICD-9-CM (procedure codes)http://hl7.org/fhir/sid/icd-9-cm2.16.840.1.113883.6.104

ICD-10 variants

Variants (other variants exist which are not listed here):

Germanyhttp://fhir.de/CodeSystem/dimdi/icd-10-gmsee HL7 Germany page
United Stateshttp://hl7.org/fhir/sid/icd-10-cm2.16.840.1.113883.6.90

Multiple Coding

Dual Coding (“dagger and asterisk” system)

For dual ("two code", “dagger and asterisk”) coding see volume 2 ICD-10 Manual), section 3.1.3 Two codes for certain conditions. In cases where two codes are required, the primary recommendation for representing this coding in FHIR (in Coding.code) is to simply use the two ICD-10 codes separated by a space, e.g. "J21.8 B95.6", as the code value (string). This is a simple form of post-coordination syntax. Alternatively, another possible syntax that may be used (which may be desirable or required in some situations) is to include the characters of the dagger (represented as † or +) for the primary code and the asterisk (*) for the secondary code as part of the post-coordinated code value, e.g. "J21.8+ B95.6*". In either case, it is recommended that the primary (+) code for the underlying generalized disease is listed first, followed by the secondary (*) code for the specific manifestation in a particular organ or site.

Dual coding in ICD-10 is used for the following (and potentially other) reasons:

  • Coding for diagnostic statements containing information about both (1) an underlying generalized disease and (2) a manifestation in a particular organ or site which is a clinical problem in its own right. This is referred to as the "dagger and asterisk" system, as it marks the primary code for the underlying disease with a dagger (†) and an optional additional code for the manifestation with an asterisk (*).
  • Other optional dual coding (noted in the tabular representation as “Use additional code, if desired ...”)
    • For local infections, classifiable to the “body systems” chapters, codes from Chapter I may be added to identify the infecting organism, where this information does not appear in the title of the rubric.
    • For neoplasms with functional activity. To the code from Chapter II may be added the appropriate code from Chapter IV to indicate the type of functional activity.
    • For neoplasms, the morphology code from Volume 1, although not part of the main ICD, may be added to the Chapter II code to identify the morphological type of the tumour.
    • For conditions classifiable to F00-F09 (Organic, including symptomatic, mental disorders) in Chapter V, where a code from another chapter may be added to indicate the cause, i.e. the underlying disease, injury or other insult to the brain.
    • Where a condition is caused by a toxic agent, a code from Chapter XX may be added to identify that agent.
    • Where two codes can be used to describe an injury, poisoning or other adverse effect: a code from Chapter XIX, which describes the nature of the injury, and a code from Chapter XX, which describes the cause.

Dual Coding Example: "Staph aureus bronchiolitis" is coded using ICD-10 codes J21.8 "Acute bronchiolitis due to other specified organisms" and B95.6 "Staphylococcus aureus as the cause of diseases classified to other chapters" as:

    <system value="http://hl7.org/fhir/sid/icd-10"/>
    <code value="J21.8 B95.6"/>

or, with the + and * characters included:

    <system value="http://hl7.org/fhir/sid/icd-10"/>
    <code value="J21.8+ B95.6*"/>
Additional Characters

Some jurisdictions (e.g. Germany) have additional coding requirements that go beyond the dual coding “dagger and asterisk” coding approach (syntax). In ICD-10-GM used in Germany the ! character is used to indicate a secondary diagnosis.

Primary diagnosis

  • S62.32 - Fracture of shaft of metacarpal bone

Secondary diagnosis

  • Z33! - Pregnancy as a secondary diagnosis

The recommended syntax for representing these combinations of codes in FHIR (in Coding.code) is to include the additional (+*!) characters when they are present and to separate the code groups with a space, as:

    <system value="http://fhir.de/CodeSystem/dimdi/icd-10-gm"/>
    <version value="2017"/>
    <code value="S62.32 Z33!"/>
Three or More Codes

The coding also may require three or sometimes more codes for a complete representation of the intended meaning. A further German coding example (from the Deutsche Kodierrichtlinien manual) includes an additional secondary diagnosis and a monitoring code.

Additional secondary diagnosis and monitoring codes

  • O09.1! - Duration of pregnancy between 5 and 13 weeks
  • Z34 - Monitoring of a regular pregnancy

A proper interpretation of this extended example is: "A patient is admitted to hospital due to a fracture of the metacarpal shaft. Since she is six weeks pregnant, the pregnancy and the monitoring of the pregnancy are coded as secondary diagnoses." The recommended FHIR representation is:

    <system value="http://fhir.de/CodeSystem/dimdi/icd-10-gm"/>
    <version value="2017"/>
    <code value="S62.32 Z33! O09.1! Z34"/>

Other jurisdictions may have similar needs for multiple coding but with different specific coding requirements. In those cases local coding manuals and authorities should be consulted to determine the recommended or expected syntax to use in a FHIR Coding instance.

Copyright/License Issues

ICD-10 is ©Copyright World Health Organization (WHO). WHO licenses its published material widely, in order to encourage maximum use and dissemination. See Licensing WHO classifications for details. The ICD variants have their own separate copyright and licensing (refer to the documentation for the particular variant for details).

ICD-X Filter Properties

No need for filters identified yet.

ICD-X Implicit Value Sets

No need for implicit value sets identified yet.