NAV
json

Introduction

The following documentation describes the JSON output from the V1 DrugBank API. This documentation complements the REST API documentation.

Indications and Conditions

Structured indications and conditions go hand in hand, and can be returned from many endpoints in the REST API.

Structured Indications

{
  "off_label": false,
  "otc_use": false,
  "military_use": false,
  "kind": "used_in_combination_as_diagnostic_agent",
  "condition": {
    "title": "occlusive vascular disease",
    "meddra_id": null,
    "icd10_id": null
  },
  "process": {
    "title": "magnetic resonance angiography",
    "meddra_id": "llt/10057784",
    "icd10_id": null
  },
  "min_age": {
    "amount": 10,
    "unit": "day"
  },
  "max_age": {
    "amount": 20,
    "unit": "year"
  },
  "with_therapies": [{
    "title": "Prostate external beam radiation therapy",
    "meddra_id": "llt/10036924",
    "icd10_id": null
  }],
  "with_drugs": [
    {
      "name": "Flutamide",
      "drugbank_id": "DB00499",
      "combination_type": "mixture"
    }
  ],
  "with_drug_categories": [
    {
    "title": "Corticosteroids",
    "drugbank_id": "DBCAT000428",
    "mesh_id": "D000305"
    }
  ],
  "combination_type": "mixture"
}

Note that the above indication includes extra data for the purpose of illustrating the related data structures.

Describes the approved conditions, diseases, or states for which a drug can safely and effectively be used. DrugBank drug indications have been structured based on their designation through the Food and Drug Administration (FDA) in the United States.

Property Type Description
off_label boolean Unapproved conditions that this drug has been shown to treat or modify. Unapproved indicates that it has not gone through the FDA approval process.
otc_use boolean Conditions that can be treated with products available over the counter (does not require a prescription).
kind string Denotes the kind of use this indication describes.
timeline string Specifies the timeline (ex. short-term), if necessary.
route string Route of administration of the drug(s) in the indication.
dose_form string Dose form in which the indication applies.
dose_strength string Dose strength in which the indication applies.
regions string array A list of regions to which this indication applies.
sex_group string Sex group of patients to which the indication applies. Possible values are null, “male”, “female”, or “all”.
min_age object This indication applies only to patients this age or older.
max_age object This indication applies only to patients this age or younger.
age_groups string array List of age groups to which this indication applies.
excluded_age_groups string array List of age groups to which this indication does not apply.
genetic_factors Genetic Factor array Genetic factors related to this indication.
genetic_factors.includes Genetic Factor array Genetic factors in patients for which this indication is applicable.
genetic_factors.excludes Genetic Factor array Genetic factors which exclude patients from this indication.
combination_drugs simplified Drug array Denotes drugs administered in combination for this indication.
adjunct_drugs simplified Drug array Denotes drugs administered as adjuncts for this indication.
combination_drug_categories simplified Category array Denotes drug categories administered in combination for this indication.
adjunct_drug_categories simplified Category array Denotes drug categories administered as adjuncts for this indication.
combination_type string Describes how the indication combines drugs.

Some indication properties contain lists of simple objects, described in the table below:

Property Array? Item Properties
combination_drugs array drugbank_id, name
adjunct_drugs array drugbank_id, name
combination_drug_categories array drugbank_id, title, mesh_id
adjunct_drug_categories array drugbank_id, title, mesh_id
min_age object amount (integer), unit (string, one of “day”, “week”, “month”, “year”)
max_age object amount (integer), unit (string, one of “day”, “week”, “month”, “year”)

Within indications, it is commonly required to describe a medical condition. These are described below, in the condition objects section. The following indication properties take this form:

Property Type Description
condition Condition The condition which that this drug has been approved to treat.
induction_of Condition A condition which is induced by the drug.
process Condition Denotes a diagnosic process in diagnost indications.
therapy Condition Used when the drug is indicated for use as a therapy rather than in the treatment or management of a condition or disease.
mechanism Condition Denotes the mechanism through which this drug achieves/contributes to the desired change.
condition_associated_with Condition array Other descriptors or conditions that are associated with the main indication.
equivalent_concept Condition A condition equivalent to the indication. Some indications can be directly mapped to MedDRA or ICD10 concepts.
with_therapies Condition array Denotes adjunct therapies in adjunct indications.
patient_characteristics Condition array List of one or more patient characteristics. Example: “immunocompromised”.
excluded_patient_characteristic Condition array List of characteristics which exclude patients from this indication.

combination_type

Combination indications include a combination_type field which denotes the type of combination described. This field can take on one of the 3 values listed in the table below.

combination_type Value Description
product Indication refers to a single product with multiple ingredients
mixture Indication refers to many products which use this ingredient along with others. In those combination products, each ingredient may have a distinct purpose. Example: cough/cold products often combine many ingredients, each with a separate purpose.
regimen Indication refers to a drug (potentially in a combination product) which is used with other products as part of a treatment regimen or cocktail.

Some indications apply to a combination product being used as part of a regimen. These indications will have a "combination_type": "regimen" value, which may obscure the fact that some of the drugs in with_drugs are used in a combination product with the indicated drug. For this reason, each drug in the with_drugs array is given its own combination_type field. Generally this matches the combination_type of the enclosing indication, but in the product/regimen scenario, any of the drugs in with_drugs with "combination_type": "product" are part of the combination product including the main drug of this indication.

Genetic Factors

Describes a genetic factor for indications, or conditions.

Property Type Description
gene Condition A condition describing the gene which is most central to this genetic factor.
mutation Condition A condition describing the genetic mutation which is most central to this genetic factor.
positive_finding Condition A condition describing a positive finding of this genetic mutation.
negative_finding Condition A condition describing a negative finding of this genetic mutation.
related_genes Condition array Genes related to this genetic factor.

Condition Objects

{
  "title": "magnetic resonance angiography",
  "drugbank_id": "DBCOND0000008",
  "meddra_id": "llt/10057784",
  "icd10_id": null,
  "snomed_id": null,

  "related_concepts": [{
    "title": "magnetic resonance imaging",
    "drugbank_id": "DBCOND0000007",
    "meddra_id": null,
    "icd10_id": null
  }]
}

Condition objects with title, meddra_id, icd10_id, and snomed_id properties are used in several places in structured indication objects. Often, condition objects denote a medical condition, but they are also used to describe procedures, therapies, and genes.

Condition objects have the following properties

Property Type Description
title string Name/description of the condition
drugbank_id string DrugBank condition identifier
meddra_id string Medical Dictionary for Regulatory Activities (MedDRA) identifier.
icd10_id string International Statistical Classification of Diseases and Related Health Problems 10th Revision(ICD-10) identifier
snomed_id string SNOMED CT identifier.
uniprot_id string Universal Protein Resource (UniProt) identifer; used for describing genes associated with the specific condition.
related_concepts Condition array List of related conditions.
as_drug Drug The DrugBank drug of the same name as this condition, if any exists.
as_drug_category Category The DrugBank drug category of the same name as this condition, if any exists.
modification_of Object See below
combination_of Object See below

combination_of

{
  "title": "Conjunctivitis caused by chlamydia",
  "drugbank_id": "DBCOND0021916",
  "meddra_id": "pt/10010745",
  "icd10_id": "c/A74.0",

  "synonyms": [
    "Conjunctivitis chlamydial",
    "Chlamydial Conjunctivitis",
    "Inclusion blenorrhoea",
    "Inclusion blenorrhea",
    "Conjunctivitis, Inclusion",
    "Paratrachoma",
    "Inclusion conjunctivitis"
  ],
  "combination_of": {
    "additional_characteristics": [],
    "caused_by": [
      {
        "title": "Chlamydial Infections",
        "drugbank_id": "DBCOND0020995",
        "meddra_id": "hlt/10008561",
        "icd10_id": "c/A74.9",
        "uniprot_id": null
      }
    ],
    "included_conditions": [
      {
        "title": "Conjunctivitis",
        "drugbank_id": "DBCOND0009989",
        "meddra_id": "llt/10010741",
        "icd10_id": "c/H10.9",
        "uniprot_id": null
      }
    ],
    "excluded_conditions": []
  }
}

This property describes the outer Condition as a combination of other conditions. Often, this is used to tie a group of conditions to each individual condition which are more likely to have a MedDRA ID, ICD10 ID, etc.

Property Type Description
caused_by Condition array Used to describe when the condition is caued by another, prior disease, condition, or physiological state.
included_conditions Condition array
excluded_conditions Condition array Conditions that can not be treated with this drug.
additional_characteristics Condition array Characteristic of the combination condition.

modification_of

{
  "title": "acute, non-severe allergic rhinitis",
  "modification_of": {
    "base": {
      "title": "allergic rhinitis"
    },
    "severity": {
      "includes": [ "acute" ],
      "excludes": [ "severe" ]
    }
  }
}

This property describes the outer Condition as a modification to another condition. Often, this is used to tie a slightly more specific form of a condition to a more general form, which is more likely to have a MedDRA ID, ICD10 ID, etc. For instance, “acute allergic rhinitis” could be considered to be “allergic rhinitis” with the additional modifier “acute”.

Property Type Description
base Condition The main condition which is being modified.
location string Used to describe when drug use is specific to a condition in/on a certain body part.
condition_stage string A more specific form of condition descriptors that are used to designate cancer stages. These provide a description of the extent to which a neoplasm has developed or spread from its site of origin.
condition_status string Condition status descriptors are similar to condition severity descriptors, but are more closely related to the progression of the disease or the disease course. These are often used to describe chronic conditions or infections with alternating periods of active and suppressed symptoms, such as Multiple Sclerosis.
severity object A specific type of condition association that describes the severity of the main condition; may be informed by duration, symptoms, and/or stages of the main condition or disease.
severity.includes string array Condition severity indicators that would include the main condition for use by the drug.
severity.excludes string array Condition severity indicators that would exclude the main condition for use by the drug.