Disease annotation data

Data sources

We currently obtain disease annotation data from several data resources and keep them up-to-date, so that you don’t have to do it:

* key name: this is the key for the specific annotation data in a disease object.

The most updated information can be accessed here.


Each data source may have its own usage restrictions. Please refer to the data source pages above for their specific restrictions.

Disease object

Disease annotation data are both stored and returned as a disease object, which is essentially a collection of fields (attributes) and their values:

    "_id": "MONDO:0020753",
    "_version": 1,
    "disease_ontology": {
        "_license": "https://github.com/DiseaseOntology/HumanDiseaseOntology/blob/master/DO_LICENSE.txt",
        "ancestors": [
        "children": [
        "def": "\"A viral infectious disease that has_material_basis_in Coronavirus.\" [url:https\\://www.cdc.gov/coronavirus/, url:https\\://www.ncbi.nlm.nih.gov/books/NBK7782/, url:https\\://www.who.int/health-topics/coronavirus]",
        "descendants": [
        "doid": "DOID:0080599",
        "name": "Coronavirus infectious disease",
        "parents": [
        "synonyms": {},
        "xrefs": {}
    "mondo": {
        "children": [
        "definition": "Infectious disease causes by viruses in the subfamily Orthocoronavirinae (coronaviruses). In humans, coronaviruses cause respiratory tract infections that can be mild, such as some cases of the common cold (among other possible causes, predominantly rhinoviruses), and others that can be lethal, such as SARS, MERS, and COVID-19.",
        "label": "Orthocoronavirinae infectious disease",
        "mondo": "MONDO:0020753",
        "parents": "MONDO:0005718",
        "synonyms": "coronavirus infectious disease",
        "xrefs": {
            "doid": "DOID:0080599"

The example above omits many of the available fields. For a full example, check out this example disease, or try the interactive API page.

_id field

Each individual disease object contains an “_id” field as the primary key. Where possible, MyDisease.info disease objects use MONDO as their “_id”. If a MONDO isn’t available, any one of the following datasource IDs may be used:

_score field

You will often see a “_score” field in the returned disease object, which is the internal score representing how well the query matches the returned disease object. It probably does not mean much in disease annotation service when only one disease object is returned. In disease query service, by default, the returned disease hits are sorted by the scores in descending order.

Available fields

The table below lists all of the possible fields that could be in a disease object, as well as all of their parents (for nested fields). If the field is indexed, it may also be directly queried.

Field Indexed Type Notes