ICD Schema

ICD-API uses sematic web formats RDF-XML and JSON-LD in poviding information on the entities of the classification.

This document explains the meanings of the properties used in the ICD-API. Some of these properties share the schema from the *Simple Knowledge Organization System (SKOS) as explained at the World Wide Web Consortium (W3C) document : http://www.w3.org/2009/08/skos-reference/skos.html. Others are from the ICD Schema described in this document.

Properties Used in ICD

Parent

A list of entities that are parent of the entity (super classes). In the case of ICD-11 linearizations and ICD-10, we only allow one parent per entity where as in the foundation there may be multiple parents.

SKOS broaderTransitive is used for the parent property

Schema URI: http://www.w3.org/2004/02/skos/core#broaderTransitive

Child

SKOS narrowerTransitive used for the child property

Schema URI: http://www.w3.org/2004/02/skos/core#narrowerTransitive

Title

We use SKOS prefLabel for the ICD titles.

Schema URI: http://www.w3.org/2004/02/skos/core#prefLabel

Description (Definition)

The description is a short characterisation of the entity that states things that are always true about a disease or condition and necessary to understand the scope of the rubric

SKOS defition property is used for the ICD description.

Schema URI: http://www.w3.org/2004/02/skos/core#definition

Additional Information (Long Definition)

This is a text field that is not mandatory, but that may contain any additional information about, or characteristics of, the diseases or conditions included in the entity. This text field provides more context for the entity. For example, the most common epidemiologic circumstances, putative or highly suspected aetiologic agents, or other information that may not always be true but may be common, typical, or expected. Additional information was formally called 'long definition'.

Schema URI: http://id.who.int/icd/schema/longDefinition

Fully Specified Name

This is an unambiguous title that does not assume context. For example, "systemic illness with predominant gastrointestinal diarrheal symptoms attributable to vibrio cholera" as opposed to "cholera" or "other" (where the meaning of other would have been clear from the hierarchical context.)

Schema URI: http://id.who.int/icd/schema/fullySpecifiedName

Synonym

SKOS altLabel property is used for the ICD synonyms.

Schema URI: http://www.w3.org/2004/02/skos/core#altLabel

Inclusion

Within the coded categories there are typically other optional diagnostic terms. These are known as 'inclusion terms' and are given, in addition to the title, as examples of the diagnostic statements to be classified to that category.

They may refer to different conditions or be synonyms. They are not a sub-classification of the category. Inclusion terms are listed primarily as a guide to the content of the category, in addition to the definition. Many of the items listed relate to important or common terms belonging to the category. Others are borderline conditions or sites listed to distinguish the boundary between one subcategory and another. The lists of inclusion terms are by no means exhaustive.

Schema URI: http://id.who.int/icd/schema/inclusion

Exclusion

Certain categories contain lists of 'Exclusions'. These are terms which are classified elsewhere. An example of this is 6A40 Hyperfunction of pituitary gland which excludes Cushing syndrome (6A50)

Exclusions serve as a cross reference in ICD and help to delimitate the boundaries of a category.

Schema URI: http://id.who.int/icd/schema/exclusion

Narrower Term

Narrower terms are terms included in an entity which are not synonyms but rather have a narrower meaning. Most of the time we have additional child entities for such narrower concepts but in some situations they are contained as terms included in an entity

Schema URI: http://id.who.int/icd/schema/narrowerTerm

Browser Url

ICD Browser is a web site that allows users see the ICD in its hiearachichal structure at the same time providing search and post-coordination features.

Browser Url property provides a direct link to the classification or an entity in the classification in the WHO's online ICD Browser.

Schema URI: http://id.who.int/icd/schema/browserUrl

Code

The classification code used for the entity. Applicable in ICD-10 and ICD-11 Linearizations

Schema URI: http://id.who.int/icd/schema/code

Source

Source points to the URI of the foundation entity when you are at a release end point.

Schema URI: http://id.who.int/icd/schema/source

Foundation Child Elsewhere

ICD-11 Foundation allows multiple parenting which means a category could be located in more than place in the foundation component. However, this is not possible for ICD-11 linearizations such as in ICD-11 MMS in which a category must be located at a single location. When looking at a linearization entity, this property would list the foundation children that are not children in the linearization.

The ICD-11 Browser shows them in gray colour therefore they sometimes referred as grey children.

Schema URI: http://id.who.int/icd/schema/foundationChildElsewhere

Index Term

ICD-11 Index terms are generated from the terms (titles, inclusions, narrower terms) included in the entity as well as from the foundation entities under the linearization shore line. The IndexTerm property includes all of the index terms of a linearization entity in one place.

Schema URI: http://id.who.int/icd/schema/indexTerm

Class Kind

An ICD-11 linearization category or an ICD-10 could have one of the following class kinds:

  1. chapter (top level entities in the classification)
  2. block (Higher level entities that do not have ICD codes)
  3. window (only in ICD-11) Same as block but does not have children in the linearization. It has only other foundation children located elsewhere in the classification.
  4. category (Entities that have ICD codes)

Schema URI: http://id.who.int/icd/schema/classKind

Coding Note

Additional information or guidelines provided to the user to be used during the ICD coding process.

Schema URI: http://id.who.int/icd/schema/codingNote

Release Date

The date that the foundation or the linearization has been released

Schema URI: http://id.who.int/icd/schema/releaseDate

Version

Used with the release URIs when a minor is not supplied and lists all available versions of the requested entity.

Schema URI: http://id.who.int/icd/schema/version

Last Version

Again used with the release URIs when a minor is not supplied and shows which of the minor version is the latest version.

Schema URI: http://id.who.int/icd/schema/latestVersion

More

ICD-11 Content model has more properties than the ones listed above. They will be made available as the content gets ready.

Especially, there will be additions that provide information on the post-coordination system.