NAV

Introduction

Welcome to the DrugBank API! You can use our API to access DrugBank API endpoints, which can get information on drugs, drug products, and drug interactions in our database.

The DrugBank API is organized around REST. Our API has predictable, resource-oriented URLs, and uses HTTP response codes to indicate API errors. We use built-in HTTP features, like HTTP authentication and HTTP verbs, which are understood by off-the-shelf HTTP clients. JSON is returned by all API responses, including errors, although our API libraries convert responses to appropriate language-specific objects.

You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.

Selecting your country/region

The DrugBank API is optionally scoped by region of availability (currently only U.S., Canada, and E.U. are available). The URL you use to access the API will determine the drugs, products, etc. that are returned.

If a product / drug appears in the results under a region scope, it means it is available in that region. Once a drug is no longer available (if a drug is withdrawn for example), it will no longer appear in the results.

For example, to search for available drug products by name in Canada, you would use the following URL:

https://api.drugbankplus.com/v1/ca/drug_names?q=abacavir

The following country/codes are available:

Country Code Base URL
United States us https://api.drugbankplus.com/v1/us
Canada ca https://api.drugbankplus.com/v1/ca
European Union eu https://api.drugbankplus.com/v1/eu

Searching without a region

You can search for all drugs / products by not providing a region scope. This will return all drugs / products that are available in ANY region.

Authentication

To authorize, use this code:

# With cURL, you can just pass the correct header with each request
curl -L 'https://api.drugbankplus.com/v1/endpoint' 
-H 'Authorization: mytoken'

Make sure to replace mytoken with your API key.

DrugBank uses API keys to allow access to the API. To request an API contact us.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

DrugBank expects for the API key to be included in all API requests to the server in a header that looks like the following:

Authorization: mytoken

Pagination

curl -L 'https://api.drugbankplus.com/v1/drugs?page=2' 
-H 'Authorization: mytoken' -v
...
< Link: <https://api.drugbankplus.com/v1/drugs?page=3&per_page=50>; rel="next",https://api.drugbankplus.com/v1/drugs?page=1&per_page=50>; rel="prev"
< X-Total-Count: 8221
< X-Per-Page: 50
...

Many API endpoints in the DrugBank API support pagination. Furthermore, to ensure quick response times, it is enabled by default for these endpoints.

Query Parameters

Parameter Default Description
per_page 50 Number of results per page. Any value above 50 will be ignored.
page 1

Response Headers

Header Description
Link URLs for the next, and prev pages, in the standard Link header format.
X-Total-Count Total number of results available.
X-Per-Page Number of results returned per page.

Errors

The DrugBank API uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted), and codes in the 5xx range indicate an error with DrugBank servers (these are rare).

The DrugBank API uses the following error codes:

Error Code Meaning
400 Bad Request – Your request is invalid
401 Unauthorized – Your API key is wrong
404 Not Found – The specified resource could not be found
405 Method Not Allowed – You tried to access a resource with an invalid method
406 Not Acceptable – You requested a format that isn’t json
410 Gone – The resource requested has been removed from our servers
429 Too Many Requests – You’re making too many requests! Slow down!
500 Internal Server Error – We had a problem with our server. Try again later.
503 Service Unavailable – We’re temporarially offline for maintanance. Please try again later.

Content Types

Response Body

curl -L 'https://api.drugbankplus.com/v1/drugs.json' 
-H 'Authorization: mytoken'

curl -L 'https://api.drugbankplus.com/v1/drugs' 
-H 'Authorization: mytoken' -H 'Accept: application/json'

In the DrugBank V1 API, response format will default to JSON. At the moment, this is the only format available. To specify JSON format, you can set the Accept header to Accept: application/json. You can also use the .json file extension to specify that json encoding is desired.

Request Headers

Header Description
Accept Requested MIME type of response.

Response Headers

Header Description
Content-Type MIME type of the response body.

Request Body

curl -L -X POST "https://api.drugbankplus.com/v1/ddi" \
-H "Content-Type: application/json" \
-H 'Authorization: mytoken' \
-H "Cache-Control: no-cache" -d '{
  "names": [
    "advil",
    "Reopro",
    "Eliquis",
    "7-select Advil PM"
  ]
}'

For API calls which use a POST request to send data to the DrugBank API (such as when finding drug-drug interactions by name), the request must set an appropriate Content-Type header.

Request Headers

Header Description
Content-Type MIME type of request body.

Drug Names / Autocomplete

This endpoint returns a list of drugs/product information suitable for use with autocomplete forms, for quickly finding the right drugs/products.

curl -L 'https://api.drugbankplus.com/v1/drug_names?q=viagra' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "products": [
    {
      "hits": [
        {
          "field": "name",
          "value": "<em>Viagra</em>"
        }
      ],
      "name": "Viagra",
      "prescribable_name": "Viagra 100 mg Oral Tablet",
      "country": "Canada",
      "ndc_product_codes": null,
      "dpd_codes": [
        "02239768"
      ],
      "ema_product_codes": null,
      "dosage_form": "Tablet",
      "strength": {
        "number": "100",
        "unit": "mg"
      },
      "route": "Oral",
      "approved": true,
      "unapproved": false,
      "generic": false,
      "otc": false,
      "mixture": false,
      "allergen": false,
      "vaccine": false,
      "ingredients": [
        {
          "drugbank_id": "DB00203",
          "name": "Sildenafil",
          "cas": "139755-83-2",
          "strength": {
            "number": "100",
            "unit": "mg"
          }
        }
      ],
      "images": []
    },
    {
      "hits": [
        {
          "field": "name",
          "value": "<em>Viagra</em>"
        }
      ],
      "name": "Viagra",
      "prescribable_name": "Viagra 25 mg Oral Tablet",
      "country": "EU",
      "ndc_product_codes": null,
      "dpd_codes": null,
      "ema_product_codes": [
        "EMEA/H/C/000202"
      ],
      "dosage_form": "Tablet, film coated",
      "strength": {
        "number": "25",
        "unit": "mg"
      },
      "route": "Oral",
      "approved": true,
      "unapproved": false,
      "generic": false,
      "otc": false,
      "mixture": false,
      "allergen": false,
      "vaccine": false,
      "ingredients": [
        {
          "drugbank_id": "DB00203",
          "name": "Sildenafil",
          "cas": "139755-83-2",
          "strength": {
            "number": "25",
            "unit": "mg"
          }
        }
      ],
      "images": []
    },
    "..."
  ]
}

HTTP Request

GET https://api.drugbankplus.com/v1/us/drug_names

Query Parameters

Parameter Default Description
q null The string you want to search with.
fuzzy false If set to true, enable fuzzy search (see fuzzy searching below).
include_allergens false If set to true, include allergen products in the results.
include_vaccines true If set to true, include vaccine products in the results.
include_simple_desc false If set to true, include simple descriptions for the product ingredients.
include_clinical_desc false If set to true, include clinical descriptions for the product ingredients.

Notice the hits array returned in the results. The hits contain highlighted snippets from the match. You can use these highlights in autocomplete applications. The matching part of the text is wrapped in an <em> tag, which you can style as you wish in your application. Note that the hits only contain the product name, and thus will not have a highlighted snippet if the query matches an ingredient not listed in the product name.

curl -L 'https://api.drugbankplus.com/v1/drug_names/simple?q=viagra' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "products": [
    {
      "hits": [
        {
          "field": "name",
          "value": "<em>Viagra</em> 25 mg Oral Tablet"
        }
      ],
      "name": "Viagra 25 mg Oral Tablet",
      "rx_norm_name": "Viagra 25 MG Oral Tablet",
      "country": "US",
      "brands": [
        "Viagra"
      ],
      "ndc_product_codes": [
        "00069-4200",
        "43353-0764",
        "..."
      ],
      "dpd_codes": null,
      "ema_product_codes": null,
      "dosage_forms": [
        "Tablet, film coated"
      ],
      "strength_number": "25",
      "strength_unit": "mg/1",
      "dosage_form": [
        "Tablet, film coated"
      ],
      "route": "Oral",
      "approved": true,
      "unapproved": false,
      "generic": false,
      "otc": false,
      "mixture": false,
      "allergen": false,
      "vaccine": false,
      "ingredients": [
        {
          "drugbank_id": "DB00203",
          "name": "Sildenafil",
          "cas": "139755-83-2",
          "strength_number": "25",
          "strength_unit": "mg/1"
        }
      ]
    },
    {
      "hits": [
        {
          "field": "name",
          "value": "<em>Viagra</em> 25 mg Oral Tablet"
        }
      ],
      "name": "Viagra 25 mg Oral Tablet",
      "rx_norm_name": "Viagra 25 MG Oral Tablet",
      "country": "US",
      "brands": [
        "Viagra"
      ],
      "ndc_product_codes": [
        "43063-0256"
      ],
      "dpd_codes": null,
      "ema_product_codes": null,
      "dosage_forms": [
        "Tablet, film coated"
      ],
      "strength_number": "25",
      "strength_unit": "mg/1",
      "dosage_form": [
        "Tablet, film coated"
      ],
      "route": "Oral",
      "approved": true,
      "unapproved": false,
      "generic": false,
      "otc": false,
      "mixture": false,
      "allergen": false,
      "vaccine": false,
      "ingredients": [
        {
          "drugbank_id": "DB00203",
          "name": "Sildenafil",
          "cas": "139755-83-2",
          "strength_number": "25",
          "strength_unit": "mg/1"
        }
      ]
    },
    "..."
  ]
}

Prescribable name (simple) search uses the concept of a prescribable name, the normalized, most common name used to describe a medication. The results of this search will not contain multiple brand names for a given drug. Instead the prescribable name will be unique for a dosage strength/form and a name. Product codes and brand names will be listed for each matched prescribable name.

This type of search is useful when logging medications a customer/patient may be taking. You can combine a name and a dosage strength to quickly filter your search. For example searching for viagra 25 mg will quickly return the most likely drug that the individual is taking.

HTTP Request

GET https://api.drugbankplus.com/v1/us/drug_names/simple

Query Parameters

Parameter Default Description
q null The string you want to search with.
fuzzy false If set to true, enable fuzzy search (see fuzzy searching below).
include_allergens false If set to true, include allergen products in the results.
include_vaccines true If set to true, include vaccine products in the results.
include_simple_desc false If set to true, include simple descriptions for the product ingredients.
include_clinical_desc false If set to true, include clinical descriptions for the product ingredients.

Notice the hits array returned in the results. The hits contain highlighted snippets from the match. You can use these highlights in autocomplete applications. The matching part of the text is wrapped in an <em> tag, which you can style as you wish in your application. Note that the hits only contain the prescribable name, and thus will not have a highlighted snippet if the query matches an ingredient not listed in the prescribable name.

Fuzzy Searching

This example demonstrates a misspelling of “Advil”, with fuzzy search enabled you will still get a result (try it yourself!).

curl -L 'https://api.drugbankplus.com/v1/drug_names?q=addvil&fuzzy=true' 
-H 'Authorization: mytoken'

Fuzzy searching allows for misspellings, but is not enabled by default, you must set fuzzy=true. By setting fuzzy=true you are telling the API to allow a certain number of misspellings to still count as a match (defaults to 2). You can also pass a number of misspellings in to increase the likelyhood of a match (for example, fuzzy=4 will allow 4 misspelled letters).

Products

Get a specific U.S. product

curl -L 'https://api.drugbankplus.com/v1/us/products/55154-2727?drug_details=true' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "ndc_product_code": "55154-2727",
  "dpd_id": null,
  "ema_product_code": null,
  "ema_ma_number": null,
  "name": "Viagra",
  "prescribable_name": "Viagra 25 mg Oral Tablet",
  "rx_norm_prescribable_name": "Viagra 25 MG Oral Tablet",
  "started_marketing_on": "1998-03-27",
  "ended_marketing_on": "2013-12-31",
  "approved_on": null,
  "schedule": null,
  "dosage_form": "Tablet, film coated",
  "route": "Oral",
  "application_number": "NDA020895",
  "generic": false,
  "otc": false,
  "approved": true,
  "country": "US",
  "mixture": false,
  "ingredients": [
    {
      "drug": {
        "drugbank_id": "DB00203",
        "name": "Sildenafil",
        "annotation_status": "complete",
        "availability_by_region": [
          {
            "region": "ca",
            "max_phase": 4,
            "marketed_prescription": true,
            "generic_available": true,
            "pre_market_cancelled": false,
            "post_market_cancelled": false
          },
          {
            "region": "eu",
            "max_phase": 4,
            "marketed_prescription": true,
            "generic_available": true,
            "pre_market_cancelled": false,
            "post_market_cancelled": false
          },
          "..."
        ],
        "description": "In eliciting its mechanism of action, sildenafil ultimately prevents or minimizes the breakdown of cyclic guanosine monophosphate (cGMP) by inhibiting ...",
        "simple_description": "A medication used to treat the inability to get or keep an erection.",
        "clinical_description": "A phosphodiesterase inhibitor used for the treatment of erectile dysfunction.",
        "synonyms": [
          "1-((3-(4,7-Dihydro-1-methyl-7-oxo-3-propyl-1H-pyrazolo(4,3-d)pyrimidin-5-yl)-4-ethoxyphenyl)sulfonyl)-4-methylpiperazine",
          "Sildenafil",
          "..."
        ],
        "pharmacology": {
          "indication_descripton": "Sildenafil is a phosphodiesterase-5 (PDE5) inhibitor that is predominantly employed for two primary indications:\r\n\r\n(1) the treatment of erectile dysfu...",
          "pharmacodynamic_description": "In vitro studies have shown that sildenafil is selective for phosphodiesterase-5 (PDE5) [F3850, F3853, F3856, F3859, F3883, F3886, L5611, L5614]...",
          "mechanism_of_action_description": "Sildenafil is an oral therapy for erectile dysfunction [A175582, F3853, F3856, F3886, L5611]...",
          "absorption": "Sildenafil is known to be quickly absorbed, with maximum plasma concentrations being observed within 30-120 minutes (with a median of 60 minutes) of or...",
          "protein_binding": "It is generally observed that sildenafil and its main circulating N-desmethyl metabolite are both estimated to be about 96% bound to plasma proteins [F...",
          "volume_of_distribution": [
            "The mean steady-state volume of distribution documented for sildenafil is approximately 105 L - a value which suggests the medication undergoes distrib..."
          ],
          "clearance": [
            "The total body clearance documented for sildenafil is 41 L/h [F3850, F3853, F3856, F3859, F3883, F3886, L5611, L5614]."
          ],
          "half_life": "The terminal phase half-life observed for sildenafil is approximately 3 to 5 hours [F3850, F3853, F3856, F3859, F3883, F3886, L5611, L5614]. ",
          "route_of_elimination": "After either oral or intravenous administration, sildenafil is excreted as metabolites predominantly in the feces (approximately 80% of the administere...",
          "toxicity_description": "In single-dose volunteer studies of doses up to 800 mg, adverse reactions were similar to those seen at lower doses, but the incidence rates and severi..."
        },
        "food_interactions": [],
        "identifiers": {
          "drugbank_id": "DB00203",
          "inchi": "InChI=1S/C22H30N6O4S/c1-5-7-17-19-20(27(4)25-17)22(29)24-21(23-19)16-14-15(8-9-18(16)32-6-2)33(30,31)28-12-10-26(3)11-13-28/h8-9,14H,5-7,10-13H2,1-4H3,...",
          "inchikey": "BNRNXUUZRGQAQC-UHFFFAOYSA-N"
        },
        "therapeutic_categories": [
          {
            "drugbank_id": "DBCAT000518",
            "name": "Phosphodiesterase 5 Inhibitors",
            "mesh_id": "D058986",
            "mesh_tree_numbers": [
              "D27.505.519.389.735.500"
            ],
            "atc_code": null,
            "atc_level": null,
            "synonyms": [
              "Inhibitors, PDE-5",
              "Inhibitors, PDE5",
              "..."
            ],
            "description": "Compounds that specifically inhibit PHOSPHODIESTERASE 5."
          },
          {
            "drugbank_id": "DBCAT000514",
            "name": "Sulfonamides",
            "mesh_id": "D013449",
            "mesh_tree_numbers": [
              "D02.065.884",
              "D02.886.590.700"
            ],
            "atc_code": "S01AB",
            "atc_level": 4,
            "synonyms": [
              "Mixtures, Sulfonamide",
              "Sulfonamide Derivatives",
              "..."
            ],
            "description": "A group of compounds that contain the structure SO2NH2."
          },
          "..."
        ]
      },
      "strength": {
        "number": "25",
        "unit": "mg/1"
      }
    }
  ],
  "therapeutic_categories": [
    {
      "drugbank_id": "DBCAT000514",
      "name": "Sulfonamides",
      "mesh_id": "D013449",
      "mesh_tree_numbers": [
        "D02.065.884",
        "D02.886.590.700"
      ],
      "atc_code": "S01AB",
      "atc_level": 4,
      "synonyms": [
        "Mixtures, Sulfonamide",
        "Sulfonamide Derivatives",
        "..."
      ],
      "description": "A group of compounds that contain the structure SO2NH2."
    },
    {
      "drugbank_id": "DBCAT000515",
      "name": "Sulfones",
      "mesh_id": "D013450",
      "mesh_tree_numbers": [
        "D02.886.590"
      ],
      "atc_code": null,
      "atc_level": null,
      "synonyms": [],
      "description": null
    },
    "..."
  ],
  "labeller": {
    "name": "Cardinal Health"
  },
  "images": [
    {
      "description": "sildenafil 25 MG Oral Tablet [Viagra]",
      "image_url_original": "//s3-us-west-2.amazonaws.com/drugbank/product_images/images/original/00069-4200-30_NLMIMAGE10_601DB05D.jpg?1498436488",
      "image_url_tiny": "//s3-us-west-2.amazonaws.com/drugbank/product_images/images/tiny/00069-4200-30_NLMIMAGE10_601DB05D.jpg?1498436488",
      "image_url_thumb": "//s3-us-west-2.amazonaws.com/drugbank/product_images/images/thumb/00069-4200-30_NLMIMAGE10_601DB05D.jpg?1498436488",
      "image_url_medium": "//s3-us-west-2.amazonaws.com/drugbank/product_images/images/medium/00069-4200-30_NLMIMAGE10_601DB05D.jpg?1498436488"
    }
  ]
}

This endpoint retrieves a specific drug product based on NDC ID.

HTTP Request

GET https://api.drugbankplus.com/v1/us/products/<NDC_ID>

URL Parameters

Parameter Description
ID The NDC ID of the product to retrieve.

Query Parameters

Parameter Default Description
drug_details false If true, returns the full details for the drug ingredients, otherwise just the drug name and DrugBank ID are returned. Requires access to the Drugs endpoint to use.
include_references false If true, includes the lists of references for the drug ingredients. Note that you also have to specify drug_details=true to see this data. See References for details.

Get a specific Canadian product

curl -L 'https://api.drugbankplus.com/v1/ca/products/02474263' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "ndc_product_code": null,
  "dpd_id": "02474263",
  "ema_product_code": null,
  "ema_ma_number": null,
  "name": "Humira",
  "prescribable_name": "Adalimumab 20 mg Injection [Humira]",
  "started_marketing_on": null,
  "ended_marketing_on": null,
  "approved_on": "2018-03-26",
  "schedule": "Prescription; Schedule D",
  "dosage_form": "Solution",
  "route": "Subcutaneous",
  "application_number": null,
  "generic": false,
  "otc": false,
  "approved": true,
  "country": "Canada",
  "mixture": false,
  "ingredients": [
    {
      "name": "Adalimumab",
      "drugbank_id": "DB00051",
      "strength": {
        "number": "20",
        "unit": "mg"
      }
    }
  ],
  "therapeutic_categories": [
    {
      "drugbank_id": "DBCAT000015",
      "name": "Antibodies, Monoclonal",
      "mesh_id": "D000911",
      "mesh_tree_numbers": [
        "D12.776.124.486.485.114.224",
        "D12.776.124.790.651.114.224",
        "..."
      ],
      "atc_code": "L01XC",
      "atc_level": 4,
      "synonyms": [
        "Monoclonal Antibodies"
      ],
      "description": "Antibodies produced by a single clone of cells."
    },
    {
      "drugbank_id": "DBCAT000017",
      "name": "Immunoglobulins",
      "mesh_id": "D007136",
      "mesh_tree_numbers": [
        "D12.776.124.486.485",
        "D12.776.124.790.651",
        "..."
      ],
      "atc_code": "J06B",
      "atc_level": 3,
      "synonyms": [
        "Globulins, Immune",
        "Immune Globulins",
        "..."
      ],
      "description": "Multi-subunit proteins which function in IMMUNITY..."
    },
    "..."
  ],
  "labeller": {
    "name": "Abbvie"
  }
}

This endpoint retrieves a specific drug product based on DPD ID (Drug Product ID).

HTTP Request

GET https://api.drugbankplus.com/v1/ca/products/<DPD_ID>

URL Parameters

Parameter Description
ID The DPD ID of the product to retrieve.

Query Parameters

Parameter Default Description
drug_details false If true, returns the full details for the drug ingredients, otherwise just the drug name and DrugBank ID are returned. Requires access to the Drugs endpoint to use.
include_references false If true, includes the lists of references for the drug ingredients. Note that you also have to specify drug_details=true to see this data. See References for details.

Get a list of E.U. products by product code

curl -L 'https://api.drugbankplus.com/v1/eu/products/EMEA/H/C/000287' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "ndc_product_code": null,
    "dpd_id": null,
    "ema_product_code": "EMEA/H/C/000287",
    "ema_ma_number": "EU/1/99/125/001",
    "name": "Zyprexa Velotab",
    "prescribable_name": "Zyprexa 5 mg Disintegrating Oral Tablet",
    "started_marketing_on": "2000-02-03",
    "ended_marketing_on": null,
    "approved_on": null,
    "schedule": null,
    "dosage_form": "Tablet, orally disintegrating",
    "route": "Oral",
    "application_number": null,
    "generic": false,
    "otc": false,
    "approved": true,
    "country": "EU",
    "mixture": false,
    "ingredients": [
      {
        "name": "Olanzapine",
        "drugbank_id": "DB00334",
        "strength": {
          "number": "5",
          "unit": "mg"
        }
      }
    ],
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000048",
        "name": "Gastrointestinal Agents",
        "mesh_id": "D005765",
        "mesh_tree_numbers": [
          "D27.505.954.483"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Agents, Gastric",
          "Agents, Gastrointestinal",
          "..."
        ],
        "description": "Drugs used for their effects on the gastrointestinal system, as to control gastric acidity, regulate gastrointestinal motility and water flow, and impr..."
      },
      {
        "drugbank_id": "DBCAT000345",
        "name": "Antidepressive Agents",
        "mesh_id": "D000928",
        "mesh_tree_numbers": [
          "D27.505.954.427.700.122"
        ],
        "atc_code": "N06A",
        "atc_level": 3,
        "synonyms": [
          "Agents, Antidepressive",
          "Antidepressant Drugs",
          "..."
        ],
        "description": "Mood-stimulating drugs used primarily in the treatment of affective disorders and related conditions..."
      },
      "..."
    ],
    "labeller": {
      "name": "Eli Lilly Nederland B.V."
    }
  }
]

This endpoint retrieves a list of drug products based on EMA Product ID (European Medicines Agency ID). These products will have mostly the same information, although route, form and strengths may vary.

HTTP Request

GET https://api.drugbankplus.com/v1/eu/products/<EMA_ID>

URL Parameters

Parameter Description
ID The EMA ID of the product to retrieve.

Query Parameters

Parameter Default Description
drug_details false If true, returns the full details for the drug ingredients, otherwise just the drug name and DrugBank ID are returned. Requires access to the Drugs endpoint to use.
include_references false If true, includes the lists of references for the drug ingredients. Note that you also have to specify drug_details=true to see this data. See References for details.

Get a specific E.U. product by marketing authorisation number

curl -L 'https://api.drugbankplus.com/v1/eu/products/EU/1/01/174/018' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "ndc_product_code": null,
  "dpd_id": null,
  "ema_product_code": "EMEA/H/C/000335",
  "ema_ma_number": "EU/1/01/174/018",
  "name": "Starlix",
  "prescribable_name": "Starlix 180 mg Oral Tablet",
  "started_marketing_on": "2001-04-03",
  "ended_marketing_on": null,
  "approved_on": null,
  "schedule": null,
  "dosage_form": "Tablet, film coated",
  "route": "Oral",
  "application_number": null,
  "generic": false,
  "otc": false,
  "approved": true,
  "country": "EU",
  "mixture": false,
  "ingredients": [
    {
      "name": "Nateglinide",
      "drugbank_id": "DB00731",
      "strength": {
        "number": "180",
        "unit": "mg"
      }
    }
  ],
  "therapeutic_categories": [
    {
      "drugbank_id": "DBCAT000243",
      "name": "Amino Acids",
      "mesh_id": "D000596",
      "mesh_tree_numbers": [
        "D12.125"
      ],
      "atc_code": "B05XB",
      "atc_level": 4,
      "synonyms": [
        "Acids, Amino"
      ],
      "description": "Organic compounds that generally contain an amino (-NH2) and a carboxyl (-COOH) group..."
    },
    {
      "drugbank_id": "DBCAT000262",
      "name": "Amino Acids, Aromatic",
      "mesh_id": "D024322",
      "mesh_tree_numbers": [
        "D12.125.072.050"
      ],
      "atc_code": null,
      "atc_level": null,
      "synonyms": [
        "Amino Acid, Aromatic",
        "Aromatic Amino Acid",
        "..."
      ],
      "description": "Amino acids containing an aromatic side chain."
    },
    "..."
  ],
  "labeller": {
    "name": "Novartis Europharm Limited"
  }
}

This endpoint retrieves a specific drug product based on EMA MA Number (European Medicines Agency Marketing Authorisation number).

HTTP Request

GET https://api.drugbankplus.com/v1/eu/products/<EMA_MA_NUMBER>

URL Parameters

Parameter Description
EMA_MA_NUMBER The EMA MA Number of the product to retrieve.

Query Parameters

Parameter Default Description
drug_details false If true, returns the full details for the drug ingredients, otherwise just the drug name and DrugBank ID are returned. Requires access to the Drugs endpoint to use.
include_references false If true, includes the lists of references for the drug ingredients. Note that you also have to specify drug_details=true to see this data. See References for details.

Get categories for a product

curl -L 'https://api.drugbankplus.com/v1/us/products/55154-2727/categories' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drugbank_id": "DBCAT003935",
    "name": "Agents Causing Muscle Toxicity",
    "mesh_id": null,
    "mesh_tree_numbers": [],
    "atc_code": null,
    "atc_level": null,
    "categorization_kind": "indexing",
    "synonyms": [
      "Agents causing myopathy",
      "Agents causing rhabdomyolysis",
      "..."
    ],
    "description": "Agents that cause muscle disorders including significant elevations of serum creatine kinase (CK), myopathy, myalgia, myositis, and rhabdomyolysis."
  }
]

Returns an array of categories for a product, based on NDC ID, DPD ID, EMA Product ID, or EMA MA Number, depending on the region.

The category type atc or mesh can be appended on to the end of the url to specify which hierarchy to retrieve the categories from. If left blank, DrugBank categories will be returned.

This endpoint supports pagination.

See Common Category Query Parameter Values for query parameters that affect the results of this request.

Shows all products for the drug regardless of the value of source, but parent/child relationships will be limited based on source.

HTTP Request

GET https://api.drugbankplus.com/v1/us/products/<ID>/categories/<hierarchy (optional)>

URL Parameters

Parameter Description
ID The NDC ID/DPD ID/EMA Product ID/EMA MA Number of the product to retrieve the categories.

Query Parameters

Parameter Default Description
categorization_kind The categorization kind to filter by (optional).

Get product concepts linked with a product

curl -L 'https://api.drugbankplus.com/v1/us/products/55154-2727/product_concepts' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "name": "Sildenafil",
    "display_name": null,
    "drugbank_pcid": "DBPC0007087",
    "brand": null,
    "level": 1,
    "route": null,
    "form": null,
    "strengths": null,
    "standing": "active",
    "standing_updated_at": "2018-09-12",
    "standing_active_since": "1998-03-27",
    "regions": {
      "us": true,
      "canada": true,
      "eu": true
    },
    "rxnorm_concepts": [
      {
        "name": "sildenafil",
        "RXCUI": "136411"
      }
    ],
    "ingredients": [
      {
        "name": "Sildenafil",
        "drug": {
          "name": "Sildenafil",
          "drugbank_id": "DB00203"
        }
      }
    ]
  }
]

This endpoint retrieves a list of product concepts linked to a product, based on NDC ID, DPD ID, EMA Product ID, or EMA MA Number, depending on the region. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/products/<ID>/product_concepts

URL Parameters

Parameter Description
ID The NDC ID/DPD ID/EMA Product ID/EMA MA Number of the product to retrieve the linked product concepts.

Query Parameters

Parameter Default Description
level The product concept level to filter by (optional).
min_level The minimum product concept level to return (optional).
min_level The maximum product concept level to return (optional).
unbranded_only false If true, returns only product concepts without an associated brand.

Get indications linked with a product

curl -L 'https://api.drugbankplus.com/v1/us/products/55154-2727/indications' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "kind": "management_of",
    "off_label": false,
    "otc_use": false,
    "drug": {
      "name": "Sildenafil",
      "drugbank_id": "DB00203"
    },
    "regions": "US",
    "condition": {
      "name": "Erectile Dysfunction",
      "drugbank_id": "DBCOND0029956",
      "meddra_id": "llt/10061461",
      "snomed_id": "c/398175007",
      "icd10_id": "c/N52.9"
    }
  }
]

This endpoint retrieves a list of indications linked to a product, based on NDC ID, DPD ID, EMA Product ID, or EMA MA Number, depending on the region. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/products/<ID>/indications

URL Parameters

Parameter Description
ID The NDC ID/DPD ID/EMA Product ID/EMA MA Number of the product to retrieve the linked indications.

Query Parameters

Parameter Default Description
off_label null Limits results by the value of the off_label attribute of the indications.
otc_use null Limits results by the value of the otc_use attribute of the indications.
kind null Limits results by the value of the kind attribute of the indications.

Get drug-drug interactions for a product

curl -L 'https://api.drugbankplus.com/v1/us/products/55154-2727/ddi?severity=moderate' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "product_ingredient": {
      "drugbank_id": "DB00203",
      "name": "Sildenafil"
    },
    "affected_product_ingredient": {
      "drugbank_id": "DB11898",
      "name": "2,4-thiazolidinedione"
    },
    "description": "The therapeutic efficacy of 2,4-thiazolidinedione can be increased when used in combination with Sildenafil.",
    "extended_description": "Sulfonamides increase the hypoglycemic effect of blood glucose lowering agents which may reduce blood sugar levels and produce an intensified effect...",
    "action": "increase_therapeutic_efficacy",
    "severity": "moderate",
    "subject_dosage": null,
    "affected_dosage": null,
    "evidence_level": "level_2",
    "management": "Monitor patient response and suspend treatment if there are signs of hypoglycemia."
  }
]

This endpoint retrieves a list of drug-drug interactions linked to a product, based on NDC ID, DPD ID, EMA Product ID, or EMA MA Number, depending on the region. The product_ingredient refers to the interacting ingredient in the specified product, while the affected_product_ingredient is the drug it interacts with. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/products/<ID>/ddi

URL Parameters

Parameter Description
ID The NDC ID/DPD ID/EMA Product ID/EMA MA Number of the product to retrieve the linked interactions.

Query Parameters

Parameter Default Description
severity null Limits results by the severity of the interactions. May be major, moderate, or minor.
include_references false If true, includes the references for each interaction. See drug-drug interactions for details.

Get adverse effects linked with a product

curl -L 'https://api.drugbankplus.com/v1/us/products/55154-2727/adverse_effects' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drug": {
      "name": "Sildenafil",
      "drugbank_id": "DB00203"
    },
    "evidence_type": [
      "clinical_trial"
    ],
    "regions": "US",
    "age_groups": [
      "adult"
    ],
    "incidences": [
      {
        "kind": "experimental",
        "percent": "16-46%"
      },
      {
        "kind": "placebo",
        "percent": "4-39%"
      }
    ],
    "effect": {
      "name": "Headache",
      "drugbank_id": "DBCOND0017979",
      "meddra_id": "hlgt/10019231",
      "snomed_id": "c/206946005",
      "icd10_id": "c/R51"
    }
  }
]

This endpoint retrieves a list of adverse effects linked to a product, based on NDC ID, DPD ID, EMA Product ID, or EMA MA Number, depending on the region. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/products/<ID>/adverse_effects

URL Parameters

Parameter Description
ID The NDC ID/DPD ID/EMA Product ID/EMA MA Number of the product to retrieve the linked adverse effects.

Get contraindications linked with a product

curl -L 'https://api.drugbankplus.com/v1/us/products/16590-0022/contraindications' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drug": {
      "name": "Acetaminophen",
      "drugbank_id": "DB00316"
    },
    "route": [],
    "dose_form": [],
    "hypersensitivity": [
      "Acetaminophen"
    ],
    "lab_values": [],
    "recommended_actions": [],
    "sex_group": "all",
    "regions": "US",
    "patient_conditions": [
      {
        "name": "Drug Hypersensitivity",
        "drugbank_id": "DBCOND0032673",
        "meddra_id": "llt/10020756",
        "snomed_id": "c/157757006",
        "icd10_id": "c/T88.7"
      }
    ]
  }
]

This endpoint retrieves a list of contraindications linked to a product, based on NDC ID, DPD ID, EMA Product ID, or EMA MA Number, depending on the region. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/products/<ID>/contraindications

URL Parameters

Parameter Description
ID The NDC ID/DPD ID/EMA Product ID/EMA MA Number of the product to retrieve the linked contraindications.

Get packages for a product

curl -L 'https://api.drugbankplus.com/v1/us/products/63304-803/packages' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "package_ndc_code": "63304-0803-30",
    "description": "30 in 1 BOTTLE",
    "amount": "30",
    "unit": "1",
    "form": "BOTTLE"
  },
  {
    "package_ndc_code": "63304-0803-05",
    "description": "500 in 1 BOTTLE",
    "amount": "500",
    "unit": "1",
    "form": "BOTTLE"
  }
]

This endpoint retrieves a list of top level packages for a product, based on NDC ID, DPD ID, EMA Product ID, or EMA MA Number, depending on the region. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/products/<ID>/packages

URL Parameters

Parameter Description
ID The NDC ID/DPD ID/EMA Product ID/EMA MA Number of the product to retrieve the packages.

Product Concepts

About Product Concepts

DrugBank ID Title Level Ingredients? Exact Ingredients? Strength? Route? Form? Brand?
DBPC0017857 Tamoxifen 1 yes no no no no no
DBPC0017859 Tamoxifen 10 mg 2 yes no yes no no no
DBPC0017861 Tamoxifen Oral 2 yes no no yes no no
DBPC0103411 Tamoxifen Tablet 2 yes no no no yes no
DBPC0017858 Tamoxifen citrate 2 yes yes no no no no
DBPC0017863 Tamoxifen 10 mg Oral 3 yes no yes yes no no
DBPC0104223 Tamoxifen 10 mg Tablet 3 yes no yes no yes no
DBPC0103415 Tamoxifen Oral Tablet 3 yes no no yes yes no
DBPC0017860 Tamoxifen citrate 10 mg 3 yes yes yes no no no
DBPC0017862 Tamoxifen citrate Oral 3 yes yes no yes no no
DBPC0103412 Tamoxifen citrate Tablet 3 yes yes no no yes no
DBPC0104225 Tamoxifen 10 mg Oral Tablet 4 yes no yes yes yes no
DBPC0017864 Tamoxifen citrate 10 mg Oral 4 yes yes yes yes no no
DBPC0104224 Tamoxifen citrate 10 mg Tablet 4 yes yes yes no yes no
DBPC0103416 Tamoxifen citrate Oral Tablet 4 yes yes no yes yes no
DBPC0104226 Tamoxifen citrate 10 mg Oral Tablet 5 yes yes yes yes yes no

Product concepts enable you to flexibly represent and query drug products. With them, you can:

  • use a stable vocabulary which abstracts over many equivalent or similar products
  • easily navigate between related products, at varying and specifiable levels of similarity
  • filter products at increasing levels of detail by taking advantage of the hierarchy of product concepts

The basis of product concepts is their many-to-many relationship to products. Each product has many product concepts, each of which match that product in a specific way. Each product concept can be shared between multiple products - if the products are similar enough. Each product concept describes a specific subset of the properties of the products it is matched to. The connection between product and product concept is derived directly from the properties that make up the two objects.

For instance, the US product with the NDC product code 51862-449 has 16 product concepts. These are listed in the table to the right. In this case, the product is not branded, so there are no product concepts with a brand. Each product concept offers a view into the product.

The value of the level property indicates how many fields are set in the product concept. The most general product concept, DBPC0017857 Tamoxifen will be shared between all products which contain Tamoxifen as their sole active ingredient. As the level increases, the product concept becomes more specific, and generally, it will match fewer products. Product concepts are derived from products, so there is a direct correspondance between the properties of the product concept and the properties of the products it is mapped to.

Product concepts can therefore be used as both a filtered version of a specific product (eg. specifying the ingredients and route, but not the form or strength), or as a search filter which can find all products matching a given criteria.

Finally, product concepts are connected in a tree structure. Each level 5 concept is a child of one or more level 4 concepts, which is a child of one or more level 3 concepts, and so on. A child concept adds one single field to its parent concepts. For instance, the level 4 DBPC0103416 Tamoxifen citrate Oral Tablet is a child of the level 3 concept DBPC0103412 Tamoxifen citrate Oral - it adds the form Tablet. It is also a child of the level 3 concept DBPC0103412 Tamoxifen citrate Tablet - to this parent it adds the route Oral.

Errors

The product concept API revolves around product concept objects. Thefore there are common error messages which may be returned from any of the product concept APIs, depending on the state of the product concept involved.

curl -L 'https://api.drugbankplus.com/v1/product_concepts?q=acetamino&hit_details=true' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "hits": [
      {
        "value": "<em>Acetamino</em>phen"
      }
    ],
    "detailed_hits": [
      {
        "field": "title",
        "matches": [
          "<em>Acetamino</em>phen"
        ],
        "match_highlight_name": "<em>Acetamino</em>phen"
      },
      {
        "field": "ingredients",
        "matches": {
          "DB00316": [
            "<em>Acetamino</em>phen",
            "p-<em>acetamino</em>phenol"
          ]
        },
        "match_highlight_name": "<em>Acetamino</em>phen"
      },
      "..."
    ],
    "name": "Acetaminophen",
    "display_name": null,
    "drugbank_pcid": "DBPC0180857",
    "brand": null,
    "level": 1,
    "route": null,
    "form": null,
    "strengths": null,
    "standing": "active",
    "standing_updated_at": "2018-09-12",
    "standing_active_since": "1950-01-01",
    "regions": {
      "us": true,
      "canada": true,
      "eu": false
    },
    "rxnorm_concepts": [
      {
        "name": "Acetaminophen",
        "RXCUI": "161"
      }
    ],
    "ingredients": [
      {
        "name": "Acetaminophen",
        "drug": {
          "name": "Acetaminophen",
          "drugbank_id": "DB00316"
        }
      }
    ]
  }
]

Product concept search allows you to quickly search product concepts. Like the most of the DrugBank API, the returned concepts can be filtered by region using a prefixed url like /v1/us/product_concepts.

By default, the search returns only top-level product concepts - concepts without route, form or strength information. Lower level concepts can be found using the level, min_level, and max_level parameters.

Search is performed by passing in a full-text search parameter q. The search results are suitable for search-as-you-type. The query parameter is used to search brand names, ingredient names and synonyms as well as ingredient names and synonyms. When query_type=advanced is used, basic boolean operations are possible in the string. Alternatively, query_type=exact can be used to return only concepts that contain exact matches to the query string.

Each result includes a hits array, which lists the best matched descriptors (brand, ingredient, and/or product names and synonyms) for that concept. These are useful for facilitating search-as-you-type queries. Adding the hit_details=true parameter will also return a detailed_hits array that gives further information on how the matches were obtained.

HTTP Request

GET https://api.drugbankplus.com/v1/us/product_concepts?q=<search_term>

Query Parameters

Parameter Default Description
q The text-search query string.
query_type simple If set to advanced, allows basic boolean operations in the query parameter q. If set to exact, only returns product concepts containing an exact match to the query string q.
hit_details false If set to true, returns additional information on matched brands/ingredients/products for the concept.
level The product concept level to filter by (optional).
min_level The minimum product concept level to return (optional).
max_level The maximum product concept level to return (optional).
unbranded_only false If true, returns only product concepts without an associated brand.
always_ingredients true If true, only returns product concepts with ingredients. Set to false to return all product concepts.
include_allergens false Include allergen product concepts in the results.
include_vaccines true Include vaccine product concepts in the results.
withdrawn false If set to include, includes product concepts for which all products have been withdrawn. If set to true, includes only product concepts for which all products have been withdrawn. If set to false, includes only product concepts with at least one non-withdrawn product.
include_simple_desc false If set to true, include simple descriptions for the product concept ingredients.
include_clinical_desc false If set to true, include clinical descriptions for the product concept ingredients.

Example Queries

Query Type Description
lido simple Product concepts which contain “lido” in the search terms (eg: “Lidocaine”).
abac -sulf advanced Product concepts which contain “abac” but not “sulf” (eg: “Abacavir” but not “Abacavir Sulfate”).
abac -sulf simple Product concepts which contain “abac” and “-sulf” (“Abacavir-sulfate”).
abac lam simple Product concepts which contain both “abac” and “lam” (eg: “Abacavir / Lamivudine”).

View Product Concept

curl -L 'https://api.drugbankplus.com/v1/product_concepts/DBPC0001930' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "name": "Pantoprazole sodium 20 mg Oral",
  "display_name": null,
  "drugbank_pcid": "DBPC0001930",
  "brand": null,
  "level": 4,
  "route": "Oral",
  "form": null,
  "strengths": "20 mg",
  "standing": "active",
  "standing_updated_at": "2018-09-12",
  "standing_active_since": "2000-05-01",
  "regions": {
    "us": true,
    "canada": false,
    "eu": false
  },
  "rxnorm_concepts": [],
  "ingredients": [
    {
      "name": "Pantoprazole as Pantoprazole sodium",
      "drug": {
        "name": "Pantoprazole",
        "drugbank_id": "DB00213"
      },
      "exact_ingredient": {
        "name": "Pantoprazole sodium",
        "drugbank_id": "DBSALT000386"
      },
      "strength": {
        "amount": "20.0",
        "per": "1.0",
        "units": "mg"
      }
    }
  ]
}

This endpoint retrieves a specific product concept based on ID (DrugBank Product Concept ID).

HTTP Request

GET https://api.drugbankplus.com/v1/us/product_concepts/<ID>

URL Parameters

Parameter Description
ID The ID of the product concept to retrieve.

Query Parameters

Parameter Default Description
include_simple_desc false If set to true, include simple descriptions for the product concept ingredients.
include_clinical_desc false If set to true, include clinical descriptions for the product concept ingredients.

View Product Concept Products

curl -L 'https://api.drugbankplus.com/v1/product_concepts/DBPC0001930/products' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "ndc_product_code": "55154-4330",
    "dpd_id": null,
    "ema_product_code": null,
    "ema_ma_number": null,
    "name": "Pantoprazole Sodium",
    "prescribable_name": "Pantoprazole sodium 20 mg Delayed Release Oral Tablet",
    "rx_norm_prescribable_name": "pantoprazole sodium 20 MG Delayed Release Oral Tablet",
    "started_marketing_on": "2013-01-23",
    "ended_marketing_on": null,
    "approved_on": null,
    "schedule": null,
    "dosage_form": "Tablet, delayed release",
    "route": "Oral",
    "application_number": "ANDA078281",
    "generic": true,
    "otc": false,
    "approved": true,
    "country": "US",
    "mixture": false,
    "ingredients": [
      {
        "name": "Pantoprazole",
        "drugbank_id": "DB00213",
        "strength": {
          "number": "20",
          "unit": "mg/1"
        }
      }
    ],
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000048",
        "name": "Gastrointestinal Agents",
        "mesh_id": "D005765",
        "mesh_tree_numbers": [
          "D27.505.954.483"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Agents, Gastric",
          "Agents, Gastrointestinal",
          "..."
        ],
        "description": "Drugs used for their effects on the gastrointestinal system, as to control gastric acidity, regulate gastrointestinal motility and water flow, and impr..."
      },
      {
        "drugbank_id": "DBCAT000541",
        "name": "Proton Pump Inhibitors",
        "mesh_id": "D054328",
        "mesh_tree_numbers": [
          "D27.505.519.389.848"
        ],
        "atc_code": "A02BC",
        "atc_level": 4,
        "synonyms": [
          "Inhibitors, Proton Pump",
          "PP Inhibitors",
          "..."
        ],
        "description": "Compounds that inhibit H(+)-K(+)-EXCHANGING ATPASE..."
      },
      "..."
    ],
    "labeller": {
      "name": "Cardinal Health"
    },
    "images": []
  }
]

This returns a list of products which are described by the product concept specified by ID (DrugBank Product Concept ID). These results are region-filtered, making it possible to find products from one or all regions by varying the URL.

HTTP Request

GET https://api.drugbankplus.com/v1/us/v1/product_concepts/<ID>/products

URL Parameters

Parameter Description
ID The ID of the product concept to retrieve.

View Product Concept Routes

curl -L 'https://api.drugbankplus.com/v1/product_concepts/DBPC0001930/routes' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "name": "Pantoprazole sodium 20 mg Oral [Protonix]",
    "display_name": "Protonix 20 mg Oral",
    "drugbank_pcid": "DBPC0002038",
    "brand": "Protonix",
    "level": 5,
    "route": "Oral",
    "form": null,
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": "2018-09-12",
    "standing_active_since": "2000-05-01",
    "regions": {
      "us": true,
      "canada": false,
      "eu": false
    },
    "rxnorm_concepts": [],
    "ingredients": [
      {
        "name": "Pantoprazole as Pantoprazole sodium",
        "drug": {
          "name": "Pantoprazole",
          "drugbank_id": "DB00213"
        },
        "exact_ingredient": {
          "name": "Pantoprazole sodium",
          "drugbank_id": "DBSALT000386"
        },
        "strength": {
          "amount": "20.0",
          "per": "1.0",
          "units": "mg"
        }
      }
    ]
  },
  {
    "name": "Pantoprazole sodium 20 mg Oral Tablet, delayed release",
    "display_name": null,
    "drugbank_pcid": "DBPC0001938",
    "brand": null,
    "level": 5,
    "route": "Oral",
    "form": "Tablet, delayed release",
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": "2018-09-12",
    "standing_active_since": "2000-05-01",
    "regions": {
      "us": true,
      "canada": false,
      "eu": false
    },
    "rxnorm_concepts": [],
    "ingredients": [
      {
        "name": "Pantoprazole as Pantoprazole sodium",
        "drug": {
          "name": "Pantoprazole",
          "drugbank_id": "DB00213"
        },
        "exact_ingredient": {
          "name": "Pantoprazole sodium",
          "drugbank_id": "DBSALT000386"
        },
        "strength": {
          "amount": "20.0",
          "per": "1.0",
          "units": "mg"
        }
      }
    ]
  }
]

This returns a list of product concepts which are more specific versions of the product concept specified by <ID>. Each of the returned product concepts has a route specified.

When using this endpoint, the "route" field of the returned product concepts can be displayed to users to communicate route separately from ingredients, brand, form, etc.

The returned routes can be further refined by passing in a full-text search parameter q. This query parameter works similarity to the Product Concepts Search and searches brand names, ingredient names and synonyms as well as ingredient names and synonyms. It also allows the query_type and hit_details parameters to be used.

HTTP Request

GET https://api.drugbankplus.com/v1/us/product_concepts/<ID>/routes

URL Parameters

Parameter Description
ID The ID of the product concept to retrieve.

Query Parameters

Parameter Default Description
q The text-search query string (optional).
query_type simple If set to advanced, allows basic boolean operations in the query parameter q. If set to exact, only returns product concepts containing an exact match to the query string q. Only applies if q is also given.
hit_details false If set to true, returns additional information on matched brands/ingredients/products for the concept. Only applies if q is also given.
withdrawn false If set to include, includes product concepts for which all products have been withdrawn. If set to true, includes only product concepts for which all products have been withdrawn. If set to false, includes only product concepts with at least one non-withdrawn product.
include_simple_desc false If set to true, include simple descriptions for the product concept ingredients.
include_clinical_desc false If set to true, include clinical descriptions for the product concept ingredients.

View Product Concept Forms

curl -L 'https://api.drugbankplus.com/v1/product_concepts/DBPC0001930/forms' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "name": "Pantoprazole sodium 20 mg Oral Tablet, delayed release",
    "display_name": null,
    "drugbank_pcid": "DBPC0001938",
    "brand": null,
    "level": 5,
    "route": "Oral",
    "form": "Tablet, delayed release",
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": "2018-09-12",
    "standing_active_since": "2000-05-01",
    "regions": {
      "us": true,
      "canada": false,
      "eu": false
    },
    "rxnorm_concepts": [],
    "ingredients": [
      {
        "name": "Pantoprazole as Pantoprazole sodium",
        "drug": {
          "name": "Pantoprazole",
          "drugbank_id": "DB00213"
        },
        "exact_ingredient": {
          "name": "Pantoprazole sodium",
          "drugbank_id": "DBSALT000386"
        },
        "strength": {
          "amount": "20.0",
          "per": "1.0",
          "units": "mg"
        }
      }
    ]
  }
]

This returns a list of product concepts which are more specific versions of the product concept specified by <ID>. Each of the returned product concepts has a form specified.

When using this endpoint, the "form" field of the returned product concepts can be displayed to users to communicate form separately from ingredients, brand, route, etc.

The returned forms can be further refined by passing in a full-text search parameter q. This query parameter works similarity to the Product Concepts Search and searches brand names, ingredient names and synonyms as well as ingredient names and synonyms. It also allows the query_type and hit_details parameters to be used.

HTTP Request

GET https://api.drugbankplus.com/v1/us/product_concepts/<ID>/forms

URL Parameters

Parameter Description
ID The ID of the product concept to retrieve.

Query Parameters

Parameter Default Description
q The text-search query string (optional).
query_type simple If set to advanced, allows basic boolean operations in the query parameter q. If set to exact, only returns product concepts containing an exact match to the query string q. Only applies if q is also given.
hit_details false If set to true, returns additional information on matched brands/ingredients/products for the concept. Only applies if q is also given.
withdrawn false If set to include, includes product concepts for which all products have been withdrawn. If set to true, includes only product concepts for which all products have been withdrawn. If set to false, includes only product concepts with at least one non-withdrawn product.
include_simple_desc false If set to true, include simple descriptions for the product concept ingredients.
include_clinical_desc false If set to true, include clinical descriptions for the product concept ingredients.

View Product Concept Strengths

curl -L 'https://api.drugbankplus.com/v1/product_concepts/DBPC0001930/strengths' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "name": "Pantoprazole sodium 20 mg Oral [Protonix]",
    "display_name": "Protonix 20 mg Oral",
    "drugbank_pcid": "DBPC0002038",
    "brand": "Protonix",
    "level": 5,
    "route": "Oral",
    "form": null,
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": "2018-09-12",
    "standing_active_since": "2000-05-01",
    "regions": {
      "us": true,
      "canada": false,
      "eu": false
    },
    "rxnorm_concepts": [],
    "ingredients": [
      {
        "name": "Pantoprazole as Pantoprazole sodium",
        "drug": {
          "name": "Pantoprazole",
          "drugbank_id": "DB00213"
        },
        "exact_ingredient": {
          "name": "Pantoprazole sodium",
          "drugbank_id": "DBSALT000386"
        },
        "strength": {
          "amount": "20.0",
          "per": "1.0",
          "units": "mg"
        }
      }
    ]
  },
  {
    "name": "Pantoprazole sodium 20 mg Oral Tablet, delayed release",
    "display_name": null,
    "drugbank_pcid": "DBPC0001938",
    "brand": null,
    "level": 5,
    "route": "Oral",
    "form": "Tablet, delayed release",
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": "2018-09-12",
    "standing_active_since": "2000-05-01",
    "regions": {
      "us": true,
      "canada": false,
      "eu": false
    },
    "rxnorm_concepts": [],
    "ingredients": [
      {
        "name": "Pantoprazole as Pantoprazole sodium",
        "drug": {
          "name": "Pantoprazole",
          "drugbank_id": "DB00213"
        },
        "exact_ingredient": {
          "name": "Pantoprazole sodium",
          "drugbank_id": "DBSALT000386"
        },
        "strength": {
          "amount": "20.0",
          "per": "1.0",
          "units": "mg"
        }
      }
    ]
  }
]

This returns a list of product concepts which are more specific versions of the product concept specified by <ID>. Each of the returned product concepts has ingredient strengths specified.

When using this endpoint, the "strengths" field of the returned product concepts can be displayed to users to communicate strength separately from ingredients, brand, route, etc.

The returned strengths can be further refined by passing in a full-text search parameter q. This query parameter works similarity to the Product Concepts Search and searches brand names, ingredient names and synonyms as well as ingredient names and synonyms. It also allows the query_type and hit_details parameters to be used.

HTTP Request

GET https://api.drugbankplus.com/v1/us/product_concepts/<ID>/strengths

URL Parameters

Parameter Description
ID The ID of the product concept to retrieve.

Query Parameters

Parameter Default Description
q The text-search query string (optional).
query_type simple If set to advanced, allows basic boolean operations in the query parameter q. If set to exact, only returns product concepts containing an exact match to the query string q. Only applies if q is also given.
hit_details false If set to true, returns additional information on matched brands/ingredients/products for the concept. Only applies if q is also given.
withdrawn false If set to include, includes product concepts for which all products have been withdrawn. If set to true, includes only product concepts for which all products have been withdrawn. If set to false, includes only product concepts with at least one non-withdrawn product.
include_simple_desc false If set to true, include simple descriptions for the product concept ingredients.
include_clinical_desc false If set to true, include clinical descriptions for the product concept ingredients.

View Product Concept Categories

curl -L 'https://api.drugbankplus.com/v1/product_concepts/DBPC0001930/categories' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drugbank_id": "DBCAT000768",
    "name": "2-Pyridinylmethylsulfinylbenzimidazoles",
    "mesh_id": "D053799",
    "mesh_tree_numbers": [
      "D02.886.640.074",
      "D03.383.725.024",
      "..."
    ],
    "atc_code": null,
    "atc_level": null,
    "categorization_kind": "indexing",
    "synonyms": [
      "2 Methylpyridine 2 Benzimidazole Sulfoxides",
      "2 Pyridinylmethylsulfinyl 2 Benzimidazoles",
      "..."
    ],
    "description": "Compounds that contain benzimidazole joined to a 2-methylpyridine via a sulfoxide linkage..."
  }
]

Returns an array of categories for the product concept specified by ID (DrugBank Product Concept ID).

The category type atc or mesh can be appended on to the end of the url to specify which hierarchy to retrieve the categories from. If left blank, DrugBank categories will be returned.

This endpoint supports pagination.

See Common Category Query Parameter Values for query parameters that affect the results of this request.

Shows all categories for the product concept regardless of the value of source, but parent/child relationships will be limited based on source.

HTTP Request

GET https://api.drugbankplus.com/v1/us/product_concepts/<ID>/categories/<hierarchy (optional)>

URL Parameters

Parameter Description
ID The DrugBank ID of the drug to retrieve the linked categories.

Query Parameters

Parameter Default Description
categorization_kind The categorization kind to filter by (optional).

View Product Concept Indications

curl -L 'https://api.drugbankplus.com/v1/product_concepts/DBPC0131467/indications' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "kind": "treatment_of",
    "off_label": false,
    "otc_use": false,
    "drug": {
      "name": "Darbepoetin alfa",
      "drugbank_id": "DB00012"
    },
    "regions": "US",
    "condition": {
      "name": "Anemia",
      "drugbank_id": "DBCOND0020261",
      "meddra_id": "pt/10002034",
      "snomed_id": "c/64593003",
      "icd10_id": "c/D64.9"
    },
    "condition_associated_with": [
      {
        "name": "Concomitant myelosuppressive chemotherapy",
        "drugbank_id": "DBCOND0020262",
        "meddra_id": "llt/10064468",
        "snomed_id": "c/64593003",
        "icd10_id": "c/D64.9"
      }
    ]
  }
]

This returns a list of indications linked to the product concept specified by ID (DrugBank Product Concept ID). This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/product_concepts/<ID>/indications

URL Parameters

Parameter Description
ID The ID of the product concept to retrieve.

Query Parameters

Parameter Default Description
off_label null Limits results by the value of the off_label attribute of the indications.
otc_use null Limits results by the value of the otc_use attribute of the indications.
kind null Limits results by the value of the kind attribute of the indications.

View Product Concept Adverse Effects

curl -L 'https://api.drugbankplus.com/v1/product_concepts/DBPC0018378/adverse_effects' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drug": {
      "name": "Tolcapone",
      "drugbank_id": "DB00323"
    },
    "route": [
      "Oral"
    ],
    "dose_form": [],
    "evidence_type": [
      "clinical_trial"
    ],
    "regions": "US",
    "incidences": [
      {
        "kind": "experimental",
        "percent": "42-51%"
      },
      {
        "kind": "placebo",
        "percent": "20%"
      }
    ],
    "effect": {
      "name": "Dyskinesia",
      "drugbank_id": "DBCOND0017935",
      "meddra_id": "pt/10013916",
      "snomed_id": "c/229694001",
      "icd10_id": "c/G24"
    },
    "patient_characteristics": [
      {
        "name": "Parkinson's Disease",
        "drugbank_id": "DBCOND0028039",
        "meddra_id": "llt/10061536",
        "snomed_id": "d/1230678016",
        "icd10_id": "c/G20"
      }
    ],
    "with_drugs": [
      {
        "name": "Levodopa",
        "drugbank_id": "DB01235"
      },
      {
        "name": "Carbidopa",
        "drugbank_id": "DB00190"
      }
    ]
  }
]

This returns a list of adverse effects linked to the product concept specified by ID (DrugBank Product Concept ID). This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/product_concepts/<ID>/adverse_effects

URL Parameters

Parameter Description
ID The ID of the product concept to retrieve.

View Product Concept Contraindications

curl -L 'https://api.drugbankplus.com/v1/product_concepts/DBPC0323661/contraindications' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drug": {
      "name": "Loxapine",
      "drugbank_id": "DB00408"
    },
    "route": [
      "Intramuscular"
    ],
    "dose_form": [
      "Injection"
    ],
    "regions": "US",
    "patient_conditions": [
      {
        "name": "Comatose",
        "drugbank_id": "DBCOND0035758",
        "meddra_id": "pt/10010071",
        "snomed_id": "c/50061006",
        "icd10_id": "c/R40.2"
      }
    ]
  }
]

This returns a list of contraindications linked to the product concept specified by ID (DrugBank Product Concept ID). This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/product_concepts/<ID>/contraindications

URL Parameters

Parameter Description
ID The ID of the product concept to retrieve.

View Product Concept Parents

curl -L 'https://api.drugbankplus.com/v1/product_concepts/DBPC0001930/parents' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "name": "Pantoprazole 20 mg Oral",
    "display_name": null,
    "drugbank_pcid": "DBPC0001929",
    "brand": null,
    "level": 3,
    "route": "Oral",
    "form": null,
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": "2018-09-12",
    "standing_active_since": "2000-05-01",
    "regions": {
      "us": true,
      "canada": true,
      "eu": true
    },
    "rxnorm_concepts": [],
    "ingredients": [
      {
        "name": "Pantoprazole",
        "drug": {
          "name": "Pantoprazole",
          "drugbank_id": "DB00213"
        },
        "strength": {
          "amount": "20.0",
          "per": "1.0",
          "units": "mg"
        }
      }
    ]
  }
]

This returns a list of product concepts which are more general versions of the product concept specified by <ID>. Each of the returned product concepts is one level more general.

The returned parents can be further refined by passing in a full-text search parameter q. This query parameter works similarity to the Product Concepts Search and searches brand names, ingredient names and synonyms as well as ingredient names and synonyms. It also allows the query_type and hit_details parameters to be used.

HTTP Request

GET https://api.drugbankplus.com/v1/us/product_concepts/<ID>/parents

URL Parameters

Parameter Description
ID The ID of the product concept to retrieve.

Query Parameters

Parameter Default Description
q The text-search query string (optional).
query_type simple If set to advanced, allows basic boolean operations in the query parameter q. If set to exact, only returns product concepts containing an exact match to the query string q. Only applies if q is also given.
hit_details false If set to true, returns additional information on matched brands/ingredients/products for the concept. Only applies if q is also given.
withdrawn false If set to include, includes product concepts for which all products have been withdrawn. If set to true, includes only product concepts for which all products have been withdrawn. If set to false, includes only product concepts with at least one non-withdrawn product.
include_simple_desc false If set to true, include simple descriptions for the product concept ingredients.
include_clinical_desc false If set to true, include clinical descriptions for the product concept ingredients.

View Product Concept Children

curl -L 'https://api.drugbankplus.com/v1/product_concepts/DBPC0001930/children' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "name": "Pantoprazole sodium 20 mg Oral [Protonix]",
    "display_name": "Protonix 20 mg Oral",
    "drugbank_pcid": "DBPC0002038",
    "brand": "Protonix",
    "level": 5,
    "route": "Oral",
    "form": null,
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": "2018-09-12",
    "standing_active_since": "2000-05-01",
    "regions": {
      "us": true,
      "canada": false,
      "eu": false
    },
    "rxnorm_concepts": [],
    "ingredients": [
      {
        "name": "Pantoprazole as Pantoprazole sodium",
        "drug": {
          "name": "Pantoprazole",
          "drugbank_id": "DB00213"
        },
        "exact_ingredient": {
          "name": "Pantoprazole sodium",
          "drugbank_id": "DBSALT000386"
        },
        "strength": {
          "amount": "20.0",
          "per": "1.0",
          "units": "mg"
        }
      }
    ]
  }
]

This returns a list of product concepts which are more specific versions of the product concept specified by <ID>. Each of the returned product concepts is one level more specific.

The returned children can be further refined by passing in a full-text search parameter q. This query parameter works similarity to the Product Concepts Search and searches brand names, ingredient names and synonyms as well as ingredient names and synonyms. It also allows the query_type and hit_details parameters to be used.

HTTP Request

GET https://api.drugbankplus.com/v1/us/product_concepts/<ID>/children

URL Parameters

Parameter Description
ID The ID of the product concept to retrieve.

Query Parameters

Parameter Default Description
q The text-search query string (optional).
query_type simple If set to advanced, allows basic boolean operations in the query parameter q. If set to exact, only returns product concepts containing an exact match to the query string q. Only applies if q is also given.
hit_details false If set to true, returns additional information on matched brands/ingredients/products for the concept. Only applies if q is also given.
withdrawn false If set to include, includes product concepts for which all products have been withdrawn. If set to true, includes only product concepts for which all products have been withdrawn. If set to false, includes only product concepts with at least one non-withdrawn product.
include_simple_desc false If set to true, include simple descriptions for the product concept ingredients.
include_clinical_desc false If set to true, include clinical descriptions for the product concept ingredients.

View Product Concepts by RxNorm Concept ID (RXCUI)

curl -L 'https://api.drugbankplus.com/v1/product_concepts/rxnorm/6387' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "name": "Lidocaine",
    "display_name": null,
    "drugbank_pcid": "DBPC0005263",
    "brand": null,
    "level": 1,
    "route": null,
    "form": null,
    "strengths": null,
    "standing": "active",
    "standing_updated_at": "2018-09-12",
    "standing_active_since": "1948-11-19",
    "regions": {
      "us": true,
      "canada": true,
      "eu": false
    },
    "rxnorm_concepts": [
      {
        "name": "Lidocaine",
        "RXCUI": "6387"
      }
    ],
    "ingredients": [
      {
        "name": "Lidocaine",
        "drug": {
          "name": "Lidocaine",
          "drugbank_id": "DB00281"
        }
      }
    ]
  }
]

This returns a list of product concepts which have been mapped to the provided RXCUI. The relationship between RXCUI and DrugBank product concepts is many-to-many. If the specified RXCUI is not understood, or has not yet been imported into DrugBank, then a 404 error will be raised. If the RXCUI is understood, but the specified RxNorm concept is not considered equivalent to any DrugBank product concept, then an empty array will be returned. This API supports pagination, although results will rarely, if ever be paginated with the default per-page setting of 50 results per page.

HTTP Request

GET https://api.drugbankplus.com/v1/product_concepts/rxnorm/<RXCUI>

URL Parameters

Parameter Description
ID The RXCUI of the RxNorm concept for which to retrieve product concepts.

Query Parameters

Parameter Default Description
withdrawn false If set to include, includes product concepts for which all products have been withdrawn. If set to true, includes only product concepts for which all products have been withdrawn. If set to false, includes only product concepts with at least one non-withdrawn product.
include_simple_desc false If set to true, include simple descriptions for the product concept ingredients.
include_clinical_desc false If set to true, include clinical descriptions for the product concept ingredients.

View Product Concept Revocation

curl -L 'https://api.drugbankplus.com/v1/product_concepts/DBPC0151796/revocation' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "drugbank_pcid": "DBPC0151796",
  "alternate_drugbank_pcids": [],
  "standing": "revoked",
  "revoked_at": "2018-01-11",
  "historical_data": {
    "name": "Estradiol valerate / Testosterone Enanthate Intramuscular",
    "route": "Intramuscular",
    "rxnorm_ids": [],
    "ingredients": [
      {
        "drug": {
          "name": "Testosterone",
          "drugbank_id": "DB00624"
        },
        "exact_ingredient": {
          "name": "Testosterone Enanthate",
          "drugbank_id": "DBSALT001030"
        }
      },
      {
        "drug": {
          "name": "Estradiol",
          "drugbank_id": "DB00783"
        },
        "exact_ingredient": {
          "name": "Estradiol valerate",
          "drugbank_id": "DBSALT000068"
        }
      }
    ]
  },
  "suggested_replacements": [
    {
      "name": "Estradiol valerate / Testosterone enanthate Intramuscular",
      "drugbank_pcid": "DBPC0340214",
      "regions": {
        "us": false,
        "canada": false,
        "eu": false
      }
    },
    {
      "name": "Estradiol valerate 6.5 mg / Testosterone enanthate 100 mg Intramuscular",
      "drugbank_pcid": "DBPC0340215",
      "regions": {
        "us": false,
        "canada": false,
        "eu": false
      }
    },
    "..."
  ]
}

When a drug or product ingredient is revoked, the related product concepts must also be revoked. They refer to DrugBank entities which no longer exist, so they cannot be properly represented. However, a historical snapshot of its data is captured when a product concept is revoked. This data can be accessed through the revocation endpoint, which will also attempt to suggest product concepts which may be suitable replacements for the revoked concept.

Plese note that some or all of the referenced ingredients may no longer be available.

HTTP Request

GET https://api.drugbankplus.com/v1/us/product_concepts/<ID>/revocation

URL Parameters

Parameter Description
ID The ID of the product concept for which to retrieve the revocation data.

Drugs

Get a specific drug

curl -L 'https://api.drugbankplus.com/v1/drugs/DB00316' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "drugbank_id": "DB00316",
  "name": "Acetaminophen",
  "annotation_status": "complete",
  "availability_by_region": [
    {
      "region": "ca",
      "max_phase": 4,
      "marketed_prescription": true,
      "generic_available": true,
      "pre_market_cancelled": false,
      "post_market_cancelled": false
    },
    {
      "region": "eu",
      "max_phase": 4,
      "marketed_prescription": false,
      "generic_available": false,
      "pre_market_cancelled": true,
      "post_market_cancelled": false
    },
    "..."
  ],
  "description": "Acetaminophen (paracetamol), also commonly known as _Tylenol_, is the most commonly taken analgesic worldwide and is recommended as first-line therapy ...",
  "simple_description": "A medication used to reduce fever and treat pain.",
  "clinical_description": "An analgesic drug used alone or in combination with opioids for pain management, and as an antipyretic agent.",
  "synonyms": [
    "4-(Acetylamino)phenol",
    "4-acetamidophenol",
    "..."
  ],
  "pharmacology": {
    "indication_descripton": "In general, acetaminophen is used for the treatment of mild to moderate pain and reduction of fever [F4124]...",
    "pharmacodynamic_description": "Animal and clinical studies have determined that acetaminophen has both antipyretic and analgesic effects...",
    "mechanism_of_action_description": "Although acetaminophen's exact mechanism of action has not been fully established, according to the FDA label [FDA label], it is categorized as an NSAI...",
    "absorption": "Acetaminophen has 88% oral bioavailability and reaches its highest plasma concentration 90 minutes after ingestion [A35815]...",
    "protein_binding": "The binding of acetaminophen to plasma proteins is low (ranging from 10% to 25%), when given at therapeutic doses [FDA label].",
    "volume_of_distribution": [
      "Volume of distribution is about 0.9L/kg. 10 to 20% of the drug is bound to red blood cells [A176357].",
      "",
      "..."
    ],
    "clearance": [
      "Adults: 0.27 L/h/kg following a 15 mg/kg intravenous (IV) dose [FDA label].",
      "Children: 0.34 L/h/kg following a 15 mg/kg intravenous (IV dose) [FDA label].",
      "..."
    ],
    "half_life": "The half-life for adults is 2...",
    "route_of_elimination": "Acetaminophen metabolites are mainly excreted in the urine...",
    "toxicity_description": "LD50 = 338 mg/kg (oral, mouse); LD50 = 1944 mg/kg (oral, rat)  [F4133]\r\n\r\n**Overdose and liver toxicity** \r\n\r\nAcetaminophen overdose may be manifested ..."
  },
  "food_interactions": [
    "Avoid alcohol (may increase risk of hepatotoxicity).",
    "Take without regard to meals."
  ],
  "identifiers": {
    "drugbank_id": "DB00316",
    "inchi": "InChI=1S/C8H9NO2/c1-6(10)9-7-2-4-8(11)5-3-7/h2-5,11H,1H3,(H,9,10)",
    "inchikey": "RZVAJINKPMORJF-UHFFFAOYSA-N"
  },
  "therapeutic_categories": [
    {
      "drugbank_id": "DBCAT000934",
      "name": "Cytochrome P-450 CYP3A Inhibitors",
      "mesh_id": "D065692",
      "mesh_tree_numbers": [
        "D27.505.389.500.503",
        "D27.505.519.389.335.503"
      ],
      "atc_code": null,
      "atc_level": null,
      "synonyms": [
        "CYP3A Inhibitors",
        "Cytochrome P 450 CYP3A Inhibitors",
        "..."
      ],
      "description": "Drugs and compounds which inhibit or antagonize the biosynthesis or actions of CYTOCHROME P-450 CYP3A."
    },
    {
      "drugbank_id": "DBCAT003661",
      "name": "Miscellaneous Analgesics and Antipyretics",
      "mesh_id": null,
      "mesh_tree_numbers": [],
      "atc_code": null,
      "atc_level": null,
      "synonyms": [],
      "description": null
    }
  ]
}

This endpoint retrieves a specific drug based on DrugBank ID.

HTTP Request

GET https://api.drugbankplus.com/v1/us/drugs/<ID>

URL Parameters

Parameter Description
ID The DrugBank ID of the drug to retrieve.

Query Parameters

Parameter Default Description
include_references false If true, includes the list of references for this drug. See References for details.

Get products linked with a drug

curl -L 'https://api.drugbankplus.com/v1/drugs/DB00316/products' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "ndc_product_code": "52124-0111",
    "dpd_id": null,
    "ema_product_code": null,
    "ema_ma_number": null,
    "name": "10 Person ANSI",
    "prescribable_name": "Acetaminophen / Acetylsalicylic acid / Bacitracin zinc / Benzalkonium chloride / Benzocaine / Ethanol / Ibuprofen / Lidocaine / Neomycin sulfate / Poly...",
    "started_marketing_on": "2010-04-24",
    "ended_marketing_on": null,
    "approved_on": null,
    "schedule": null,
    "dosage_form": "Kit",
    "route": "",
    "application_number": "part333",
    "generic": false,
    "otc": true,
    "approved": false,
    "country": "US",
    "mixture": true,
    "ingredients": [
      {
        "name": "Benzalkonium",
        "drugbank_id": "DB11105",
        "strength": {
          "number": "0.13",
          "unit": "g/100g"
        }
      },
      {
        "name": "Lidocaine",
        "drugbank_id": "DB00281",
        "strength": {
          "number": "0.5",
          "unit": "1/100g"
        }
      },
      "..."
    ],
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000007",
        "name": "Anticoagulants",
        "mesh_id": "D000925",
        "mesh_tree_numbers": [
          "D27.505.954.502.119"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Agents, Anticoagulant",
          "Anti-coagulant",
          "..."
        ],
        "description": "Agents that prevent clotting."
      },
      {
        "drugbank_id": "DBCAT000045",
        "name": "Antirheumatic Agents",
        "mesh_id": "D018501",
        "mesh_tree_numbers": [
          "D27.505.954.329"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Agents, Anti-Rheumatic",
          "Agents, Antirheumatic",
          "..."
        ],
        "description": "Drugs that are used to treat RHEUMATOID ARTHRITIS."
      },
      "..."
    ],
    "labeller": {
      "name": "Genuine First Aid"
    },
    "images": []
  }
]

This endpoint retrieves a list of products linked to a drug, based on DrugBank ID. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/drugs/<ID>/products

URL Parameters

Parameter Description
ID The DrugBank ID of the drug to retrieve the linked products.

Get product concepts linked with a drug

curl -L 'https://api.drugbankplus.com/v1/drugs/DB00316/product_concepts' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "name": "Acetaminophen / Ephedrine hydrochloride / Guaifenesin Oral Syrup",
    "display_name": null,
    "drugbank_pcid": "DBPC0482458",
    "brand": null,
    "level": 4,
    "route": "Oral",
    "form": "Syrup",
    "strengths": null,
    "standing": "active",
    "standing_updated_at": null,
    "standing_active_since": "2019-06-01",
    "regions": {
      "us": true,
      "canada": false,
      "eu": false
    },
    "rxnorm_concepts": [],
    "ingredients": [
      {
        "name": "Guaifenesin",
        "drug": {
          "name": "Guaifenesin",
          "drugbank_id": "DB00874"
        }
      },
      {
        "name": "Acetaminophen",
        "drug": {
          "name": "Acetaminophen",
          "drugbank_id": "DB00316"
        }
      },
      "..."
    ]
  }
]

This endpoint retrieves a list of product concepts linked to a drug, based on DrugBank ID. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/drugs/<ID>/product_concepts

URL Parameters

Parameter Description
ID The DrugBank ID of the drug to retrieve the linked product concepts.

Query Parameters

Parameter Default Description
level The product concept level to filter by (optional).
min_level The minimum product concept level to return (optional).
min_level The maximum product concept level to return (optional).
unbranded_only false If true, returns only product concepts without an associated brand.

Get categories for a drug

curl -L 'https://api.drugbankplus.com/v1/drugs/DB00993/categories' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drugbank_id": "DBCAT000276",
    "name": "Antimetabolites",
    "mesh_id": "D000963",
    "mesh_tree_numbers": [
      "D27.505.519.186",
      "D27.888.569.042"
    ],
    "atc_code": "L01B",
    "atc_level": 3,
    "categorization_kind": "therapeutic",
    "synonyms": [],
    "description": "Drugs that are chemically similar to naturally occurring metabolites, but differ enough to interfere with normal metabolic pathways..."
  }
]

Returns an array of categories for a drug, based on the DrugBank ID.

The category type atc or mesh can be appended on to the end of the url to specify which hierarchy to retrieve the categories from. If left blank, DrugBank categories will be returned.

This endpoint supports pagination.

See Common Category Query Parameter Values for query parameters that affect the results of this request.

Shows all categories for the drug regardless of the value of source, but parent/child relationships will be limited based on source.

HTTP Request

GET https://api.drugbankplus.com/v1/us/drugs/<ID>/categories/<hierarchy (optional)>

URL Parameters

Parameter Description
ID The DrugBank ID of the drug to retrieve the linked categories.

Query Parameters

Parameter Default Description
categorization_kind The categorization kind to filter by (optional).

Get indications linked with a drug

curl -L 'https://api.drugbankplus.com/v1/drugs/DB00675/indications' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "kind": "adjunct_therapy_in_treatment_of",
    "off_label": false,
    "otc_use": false,
    "sex_group": "female",
    "drug": {
      "name": "Tamoxifen",
      "drugbank_id": "DB00675"
    },
    "regions": "US",
    "condition": {
      "name": "Breast Cancer",
      "drugbank_id": "DBCOND0028036",
      "meddra_id": "llt/10006187",
      "snomed_id": "c/254837009",
      "icd10_id": "c/C50"
    }
  }
]

This endpoint retrieves a list of indications linked to a drug, based on DrugBank ID. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/drugs/<ID>/indications

URL Parameters

Parameter Description
ID The DrugBank ID of the drug to retrieve the linked indications.

Query Parameters

Parameter Default Description
off_label null Limits results by the value of the off_label attribute of the indications.
otc_use null Limits results by the value of the otc_use attribute of the indications.
kind null Limits results by the value of the kind attribute of the indications.

Get drug-drug interactions for a drug

curl -L 'https://api.drugbankplus.com/v1/drugs/DB00675/ddi?severity=moderate' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "ingredient": {
      "drugbank_id": "DB00675",
      "name": "Tamoxifen"
    },
    "affected_ingredient": {
      "drugbank_id": "DB08496",
      "name": "(R)-warfarin"
    },
    "description": "The risk or severity of bleeding can be increased when Tamoxifen is combined with (R)-warfarin.",
    "extended_description": "Coadministration of tamoxifen with anticoagulant drugs has been shown to produce an increase in the anticoagulant effect producing cases of bleeding...",
    "action": "increase_specific_adverse_effects",
    "severity": "moderate",
    "subject_dosage": null,
    "affected_dosage": null,
    "evidence_level": "level_1",
    "management": "Concomitant use of tamoxifen with vitamin K antagonists should be avoided..."
  }
]

This endpoint retrieves a list of drug-drug interactions linked to a drug, based on DrugBank ID. The ingredient refers to the specified drug, while the affected_ingredient is the drug it interacts with. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/drugs/<ID>/ddi

URL Parameters

Parameter Description
ID The DrugBank ID of the drug to retrieve the linked interactions.

Query Parameters

Parameter Default Description
severity null Limits results by the severity of the interactions. May be major, moderate, or minor.
include_references false If true, includes the references for each interaction. See drug-drug interactions for details.

Get adverse effects linked with a drug

curl -L 'https://api.drugbankplus.com/v1/drugs/DB00316/adverse_effects' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "route": [
      "Intravenous"
    ],
    "dose_form": [],
    "evidence_type": [
      "clinical_trial"
    ],
    "admin": "multiple dose",
    "regions": "US",
    "age_groups": [
      "adult"
    ],
    "incidences": [
      {
        "kind": "experimental",
        "percent": "34%"
      },
      {
        "kind": "placebo",
        "percent": "31%"
      }
    ],
    "effect": {
      "name": "Nausea",
      "drugbank_id": "DBCOND0010699",
      "meddra_id": "llt/10028813",
      "snomed_id": "c/162055004",
      "icd10_id": "c/R11.0"
    }
  }
]

This endpoint retrieves a list of adverse effects linked to a drug, based on DrugBank ID. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/drugs/<ID>/adverse_effects

URL Parameters

Parameter Description
ID The DrugBank ID of the drug to retrieve the linked adverse effects.

Get contraindications linked with a drug

curl -L 'https://api.drugbankplus.com/v1/drugs/DB00316/contraindications' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "route": [],
    "dose_form": [],
    "hypersensitivity": [
      "Acetaminophen"
    ],
    "lab_values": [],
    "recommended_actions": [],
    "sex_group": "all",
    "regions": "US",
    "patient_conditions": [
      {
        "name": "Drug Hypersensitivity",
        "drugbank_id": "DBCOND0032673",
        "meddra_id": "llt/10020756",
        "snomed_id": "c/157757006",
        "icd10_id": "c/T88.7"
      }
    ]
  },
  {
    "regions": "US",
    "patient_conditions": [
      {
        "name": "Hepatic Impairment",
        "drugbank_id": "DBCOND0031585",
        "meddra_id": "llt/10052254",
        "snomed_id": "c/197551000",
        "icd10_id": "c/K70-K77"
      }
    ]
  },
  "..."
]

This endpoint retrieves a list of contraindications linked to a drug, based on DrugBank ID. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/drugs/<ID>/contraindications

URL Parameters

Parameter Description
ID The DrugBank ID of the drug to retrieve the linked contraindications.

Get packages for a drug

curl -L 'https://api.drugbankplus.com/v1/drugs/DB00316/packages' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "package_ndc_code": "16590-0023-90",
    "description": "90 in 1 BOTTLE",
    "amount": "90",
    "unit": "1",
    "form": "BOTTLE",
    "product": {
      "ndc_product_code": "16590-0023",
      "name": "ACETAMINOPHEN AND CODEINe"
    }
  },
  {
    "package_ndc_code": "21695-0242-28",
    "description": "28 in 1 BOTTLE",
    "amount": "28",
    "unit": "1",
    "form": "BOTTLE",
    "product": {
      "ndc_product_code": "21695-0242",
      "name": "Acetaminophen and Codeine Phosphate"
    }
  },
  "..."
]

This endpoint retrieves a list of top level packages for a drug, based on DrugBank ID. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/drugs/<ID>/packages

URL Parameters

Parameter Description
ID The DrugBank ID of the drug to retrieve the packages.

Drug-Drug Interactions

Provide a list of products to get a list of interactions between the ingredients in specified products. The products can be specified by name, ingredient ID, product concept ID, or by product code.

The number of query terms that can be provided in a single query is limited to 40. These query parameters can be sent as url parameters or as JSON in the body of a POST request. A single request can mix different query terms, for instance, drug ids with product concept ids.

Common Query Parameter Values

Return a list of drug interactions, including their references:

curl -L 'https://api.drugbankplus.com/v1/ddi?drugbank_id=DB01236,DB01363&include_references=true' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "interactions": [
    {
      "ingredient": {
        "drugbank_id": "DB01236",
        "name": "Sevoflurane"
      },
      "affected_ingredient": {
        "drugbank_id": "DB01363",
        "name": "Ephedra sinica root"
      },
      "description": "Sevoflurane may increase the arrhythmogenic activities of Ephedra sinica root.",
      "extended_description": "The use of ephedra is currently either banned or strongly recommended against as being unsafe in many countries [L3650, L3651, F648]...",
      "action": "increase_specific_effects",
      "severity": "major",
      "subject_dosage": null,
      "affected_dosage": null,
      "evidence_level": "level_1",
      "management": "Avoid coadministration of ephedra with cyclopropane or halogenated hydrocarbon anesthetics whenever possible...",
      "references": {
        "literature_references": [
          {
            "ref_id": "A35004",
            "pubmed_id": 17594156,
            "citation": "Hahm TS, Lee JJ, Yang MK, Kim JA: Risk factors for an intraoperative arrhythmia during esophagectomy..."
          },
          {
            "ref_id": "A35071",
            "pubmed_id": 18941968,
            "citation": "Himmel HM: Mechanisms involved in cardiac sensitization by volatile anesthetics: general applicability to halogenated hydrocarbons? Crit Rev Toxicol..."
          },
          "..."
        ],
        "textbooks": [],
        "external_links": [
          {
            "ref_id": "L3620",
            "title": "Electronic Medicines Compendium: Ephedrine Hydrochloride Injection 3MG PER ML Monograph",
            "url": "https://www.medicines.org.uk/emc/product/3593/smpc"
          },
          {
            "ref_id": "L3650",
            "title": "National Institutes of Health: FDA Prohibits Sales of Dietary Supplements Containing Ephedra",
            "url": "https://ods.od.nih.gov/Health_Information/ephedra.aspx"
          },
          "..."
        ],
        "attachments": [
          {
            "ref_id": "F648",
            "title": "European Food Safety Authority: Scientific Opinion on Safety Evaluation of Ephedra Species for use in Food",
            "url": "//s3-us-west-2.amazonaws.com/drugbank/cite_this/attachments/files/000/000/648/original/j.efsa.2013.3467.pdf?1531845562"
          }
        ]
      }
    }
  ],
  "total_results": 1
}

For any interaction query the parameters listed in the table below can be used:

Parameter Default Description
severity null Limits results by the severity of the interactions. May be major, moderate, or minor.
include_references false If true, includes the references for each interaction. See References for details.

An explanation of some of the interaction properties:

Property Type Description
severity string The severity of this drug interaction; either minor, moderate, or major.
action string The resulting effect of this interaction on the pharmacological activity of the drug.
evidence_level integer 1: Mentioned in the the drug monograph (FDA, Health Canada, EMA, etc) and has been confirmed in clinical studies (cohort, case-control, case study etc.)
2: Has been confirmed in at least 1 cohort, case-control, or case study and may or not be mentioned in a drug monograph.

Find DDI with NDC product codes

Return a list of moderate drug interactions involving the products with the NDC codes 0169-5174 and 0013-2626:

curl -L 'https://api.drugbankplus.com/v1/us/ddi?ndc=0169-5174,0013-2626&severity=moderate' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "interactions": [
    {
      "product_ndc_product_codes": [
        "00169-5174"
      ],
      "product_name": "Activella",
      "product_ingredient": {
        "drugbank_id": "DB00783",
        "name": "Estradiol"
      },
      "affected_product_ndc_product_code": [
        "00013-2626"
      ],
      "affected_product_name": "Genotropin",
      "affected_product_ingredient": {
        "drugbank_id": "DB00052",
        "name": "Somatotropin"
      },
      "description": "The therapeutic efficacy of Somatotropin can be decreased when used in combination with Estradiol.",
      "extended_description": "Estrogens affects the actions of growth hormone (GH) at early age by stimulating pituitary GH secretion, modulating GHR-JAK2-STAT5 signalling pathway, ...",
      "action": "decrease_therapeutic_efficacy",
      "severity": "moderate",
      "subject_dosage": null,
      "affected_dosage": null,
      "evidence_level": "level_2",
      "management": "Monitor for reduced growth hormone efficacy..."
    }
  ],
  "total_results": 1
}

HTTP Request

GET https://api.drugbankplus.com/v1/us/ddi

Query Parameters

Parameter Description
ndc A comma delimited list of NDC codes.

To search by the NDC product code the NDC codes should be joined with a comma, and not include any quotations. Only the 2 segment NDC code is accepted at this time. The NDC product code will not work if searching exclusively within the ca or eu region.

Find DDI with Drug Product ID

Return a list of drug interactions involving the products with the DPD IDs 02341093 and 02282623:

curl -L 'https://api.drugbankplus.com/v1/ca/ddi?dpd=02341093,02282623' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "interactions": [
    {
      "product_dpd_ids": [
        "02341093"
      ],
      "product_name": "Accel-amlodipine",
      "product_ingredient": {
        "drugbank_id": "DB00381",
        "name": "Amlodipine"
      },
      "affected_product_dpd_id": [
        "02282623"
      ],
      "affected_product_name": "Act Risperidone",
      "affected_product_ingredient": {
        "drugbank_id": "DB00734",
        "name": "Risperidone"
      },
      "description": "Amlodipine may increase the hypotensive activities of Risperidone.",
      "extended_description": "Risperidone may induce orthostatic hypotension associated with dizziness, tachycardia, and in some patients, syncope, especially during the initial dos...",
      "action": "increase_specific_effects",
      "severity": "minor",
      "subject_dosage": null,
      "affected_dosage": null,
      "evidence_level": "level_1",
      "management": "Caution should be exercised when co-administering risperidone with agents associated with hypotension..."
    }
  ],
  "total_results": 1
}

HTTP Request

GET https://api.drugbankplus.com/v1/ca/ddi

Query Parameters

Parameter Description
dpd A comma delimited list of DPD IDs.

To search by Drug Product ID the DPD IDs should be joined with a comma, and not include any quotations. The DPD ID will not work if searching exclusively within the us or eu region.

Find DDI with EMA product code

Return a list of drug interactions involving the products with the EMA product codes EMEA/H/C/003870 and EMEA-H-C-000521:

curl -L 'https://api.drugbankplus.com/v1/eu/ddi?ema=EMEA/H/C/002615,EMEA/H/C/000122' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "interactions": [
    {
      "product_ema_product_codes": [
        "EMEA/H/C/002615"
      ],
      "product_name": "Bemfola",
      "product_ingredient": {
        "drugbank_id": "DB00066",
        "name": "Follitropin"
      },
      "affected_product_ema_product_code": [
        "EMEA/H/C/000122"
      ],
      "affected_product_name": "Refludan",
      "affected_product_ingredient": {
        "drugbank_id": "DB00001",
        "name": "Lepirudin"
      },
      "description": "Follitropin may increase the anticoagulant activities of Lepirudin.",
      "extended_description": "Due to potential inhibition of vitamin K activity by methimazole and other antithyroid agents, the activity of anticoagulants (for example, warfarin) m...",
      "action": "increase_specific_effects",
      "severity": "moderate",
      "subject_dosage": null,
      "affected_dosage": null,
      "evidence_level": "level_2",
      "management": "Additional monitoring of PT/INR should be considered, especially before surgical procedures..."
    },
    {
      "product_ema_product_codes": [
        "EMEA/H/C/002615"
      ],
      "product_name": "Bemfola Needles",
      "product_ingredient": {
        "drugbank_id": "DB00066",
        "name": "Follitropin"
      },
      "affected_product_ema_product_code": [
        "EMEA/H/C/000122"
      ],
      "affected_product_name": "Refludan",
      "affected_product_ingredient": {
        "drugbank_id": "DB00001",
        "name": "Lepirudin"
      },
      "description": "Follitropin may increase the anticoagulant activities of Lepirudin.",
      "extended_description": "Due to potential inhibition of vitamin K activity by methimazole and other antithyroid agents, the activity of anticoagulants (for example, warfarin) m...",
      "action": "increase_specific_effects",
      "severity": "moderate",
      "subject_dosage": null,
      "affected_dosage": null,
      "evidence_level": "level_2",
      "management": "Additional monitoring of PT/INR should be considered, especially before surgical procedures..."
    }
  ],
  "total_results": 2
}

HTTP Request

GET https://api.drugbankplus.com/v1/eu/ddi

Query Parameters

Parameter Description
ema A comma delimited list of EMA product codes.

To search by EMA product code the EMA codes should be joined with a comma, and not include any quotations. Dashes may be used in the place of slashes within the query codes. The EMA code will not work if searching exclusively within the us or ca region.

Find DDI with EMA MA number

Return a list of drug interactions involving the products with the EMA MA numbers EU/1/15/1008/001 and EU/1/04/273/001:

curl -L 'https://api.drugbankplus.com/v1/eu/ddi?ema_ma=EU/1/14/944/008,EU/1/96/007/006' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "interactions": [
    {
      "product_ema_ma_numbers": [
        "EU/1/96/007/006"
      ],
      "product_name": "Humalog Mix50",
      "product_ingredient": {
        "drugbank_id": "DB00046",
        "name": "Insulin Lispro"
      },
      "affected_product_ema_ma_number": [
        "EU/1/14/944/008"
      ],
      "affected_product_name": "Abasaglar",
      "affected_product_ingredient": {
        "drugbank_id": "DB00047",
        "name": "Insulin glargine"
      },
      "description": "The risk or severity of hypoglycemia can be increased when Insulin Lispro is combined with Insulin glargine.",
      "extended_description": "The primary therapeutic effect of blood glucose lowering agents is to decrease blood sugar levels...",
      "action": "increase_specific_adverse_effects",
      "severity": "moderate",
      "subject_dosage": null,
      "affected_dosage": null,
      "evidence_level": "level_2",
      "management": "Although the combined use of blood glucose agents is often times clinically appropriate, it is necessary to review and monitor the particular blood glu..."
    }
  ],
  "total_results": 1
}

HTTP Request

GET https://api.drugbankplus.com/v1/eu/ddi

Query Parameters

Parameter Description
ema_ma A comma delimited list of EMA MA numbers.

To search by EMA MA number the EMA MA numbers should be joined with a comma, and not include any quotations. Dashes may be used in the place of slashes within the query codes. The EMA MA number will not work if searching exclusively within the us or ca region.

Find DDI with Product Concepts

Return a list of drug interactions involving the Product concepts with the DrugBank IDs DBPC0248838 and DBPC0061207:

curl -L 'https://api.drugbankplus.com/v1/ddi?product_concept_id=DBPC0248838,DBPC0061207' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "interactions": [
    {
      "product_concept_id": "DBPC0061207",
      "product_concept_name": "Methylphenidate 18 mg Tablet, extended release",
      "product_ingredient": {
        "drugbank_id": "DB00422",
        "name": "Methylphenidate"
      },
      "affected_product_concept_id": "DBPC0248838",
      "affected_product_concept_name": "Isoflurane 100 % [Forane]",
      "affected_product_ingredient": {
        "drugbank_id": "DB00753",
        "name": "Isoflurane"
      },
      "description": "Methylphenidate may increase the hypertensive activities of Isoflurane.",
      "extended_description": "The prescribing information for many, but not necessarily all, formulations of methylphenidate expressly warn about the combination of methylphenidate ...",
      "action": "increase_specific_effects",
      "severity": "major",
      "subject_dosage": null,
      "affected_dosage": null,
      "evidence_level": "level_1",
      "management": "The combined use of methylphenidate with a halogenated anesthetic should be avoided..."
    }
  ],
  "total_results": 1
}

HTTP Request

GET https://api.drugbankplus.com/v1/ddi

Query Parameters

Parameter Description
product_concept_id A comma delimited list of DrugBank Product concept IDs.

To search by Product concept the Product concept IDs should be joined with a comma, and not include any quotations.

Find DDI with DrugBank ID

Return a list of drug interactions involving drug ingredients with the DrugBank IDs DB09034 and DB00615:

curl -L 'https://api.drugbankplus.com/v1/ddi?drugbank_id=DB00497,DB01193' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "interactions": [
    {
      "ingredient": {
        "drugbank_id": "DB01193",
        "name": "Acebutolol"
      },
      "affected_ingredient": {
        "drugbank_id": "DB00497",
        "name": "Oxycodone"
      },
      "description": "The metabolism of Oxycodone can be decreased when combined with Acebutolol.",
      "extended_description": "The subject drug is a known CYP2D6 inhibitor and the affected drug is metabolized by CYP2D6...",
      "action": "decrease_dynamics",
      "severity": "moderate",
      "subject_dosage": null,
      "affected_dosage": null,
      "evidence_level": "level_2",
      "management": "It is recommended to search for therapy alternatives to this combination..."
    }
  ],
  "total_results": 1
}

HTTP Request

GET https://api.drugbankplus.com/v1/ddi

Query Parameters

Parameter Description
drugbank_id A comma delimited list of DrugBank drug IDs.

To search by DrugBank ID the DrugBank IDs should be joined with a comma, and not include any quotations.

Find DDI with Product Name

Return a list of drug interactions involving the products with the products named: advil, Reopro, Eliquis and 7-select Advil PM.

curl -L -X POST 'https://api.drugbankplus.com/v1/ddi' \ 
-H 'Content-Type: application/json' \ 
-H 'Authorization: mytoken' \ 
-H 'Cache-Control: no-cache' -d '{
  "names": [
    "advil",
    "Reopro",
    "Eliquis",
    "7-select Advil PM"
  ]
}'

Example command returns JSON structured like this (results may be abbreviated):

{
  "interactions": [
    {
      "product_name": "Advil",
      "product_ingredient": {
        "drugbank_id": "DB01050",
        "name": "Ibuprofen"
      },
      "affected_product_name": "Reopro",
      "affected_product_ingredient": {
        "drugbank_id": "DB00054",
        "name": "Abciximab"
      },
      "description": "The risk or severity of bleeding can be increased when Ibuprofen is combined with Abciximab.",
      "extended_description": "Concomitant use of antiplatelet and non-steroidal anti-inflammatory agents (NSAIDs) is associated with increased risk of gastrointestinal bleeding.",
      "action": "increase_specific_adverse_effects",
      "severity": "moderate",
      "subject_dosage": null,
      "affected_dosage": null,
      "evidence_level": "level_1",
      "management": "Monitor for signs of GI bleeds in patients using both antiplatelet agents and NSAIDs concomitantly."
    },
    {
      "product_name": "Advil",
      "product_ingredient": {
        "drugbank_id": "DB01050",
        "name": "Ibuprofen"
      },
      "affected_product_name": "Eliquis",
      "affected_product_ingredient": {
        "drugbank_id": "DB06605",
        "name": "Apixaban"
      },
      "description": "The risk or severity of bleeding and gastrointestinal bleeding can be increased when Ibuprofen is combined with Apixaban.",
      "extended_description": "When ibuprofen and apixaban are coadministered, there may be an increased risk of bleeding, including serious and fatal gastrointestinal bleeding...",
      "action": "increase_specific_adverse_effects",
      "severity": "moderate",
      "subject_dosage": null,
      "affected_dosage": null,
      "evidence_level": "level_2",
      "management": "Avoid this combination when possible..."
    },
    "..."
  ],
  "total_results": 3
}

HTTP Request

POST https://api.drugbankplus.com/v1/ddi

Request Body

To search for drug-drug interactions by drug product name, JSON specifying the request should be included in the body of the request. The format of the request should follow the structure of the following example:

{"names": ["advil","Reopro","Eliquis","7-select Advil PM"]}

The API finds the product with the closest match to the input name, and returns any interactions between ingredients for all the products in the product list.

Find DDI with mixed input

Return a list of drug interactions involving the specified products, drugs, and/or product concepts:

curl -L 'https://api.drugbankplus.com/v1/ddi?ndc=0143-9503,0056-0173&drugbank_id=DB00503,DB01221,DB00331,DB00819&product_concept_id=DBPC0024484,DBPC0085378' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "interactions": [
    {
      "ingredient": {
        "drugbank_id": "DB00331",
        "name": "Metformin"
      },
      "affected_product_ndc_product_code": [
        "00056-0173"
      ],
      "affected_product_name": "Coumadin",
      "affected_product_ingredient": {
        "drugbank_id": "DB00682",
        "name": "Warfarin"
      },
      "description": "Metformin may decrease the excretion rate of Warfarin which could result in a higher serum level.",
      "extended_description": "This interaction is related to the fact that both drugs are mainly excreted renally...",
      "action": "decrease_excretion",
      "severity": "moderate",
      "subject_dosage": null,
      "affected_dosage": null,
      "evidence_level": "level_2",
      "management": "Monitor patient response when these drugs are given concomitantly..."
    },
    {
      "ingredient": {
        "drugbank_id": "DB00331",
        "name": "Metformin"
      },
      "affected_product_concept_id": "DBPC0024484",
      "affected_product_concept_name": "Abacavir",
      "affected_product_ingredient": {
        "drugbank_id": "DB01048",
        "name": "Abacavir"
      },
      "description": "Metformin may decrease the excretion rate of Abacavir which could result in a higher serum level.",
      "extended_description": "The renal excretion of drugs is the overall result of a combination of mechanisms of action of the kidneys, including glomerular filtration, passive ba...",
      "action": "decrease_excretion",
      "severity": "moderate",
      "subject_dosage": null,
      "affected_dosage": null,
      "evidence_level": "level_2",
      "management": "Monitor patient response when such drugs are given concomitantly..."
    },
    "..."
  ],
  "total_results": 32
}

The interacting ingredients in each product are identified by name and DrugBank identifier.

HTTP Request

POST https://api.drugbankplus.com/v1/ddi

To search with multiple IDs/terms, combine the paramaters as specified in the examples above into a single request. Interactions returned by this method may be drug-drug, drug-product, drug-product-concept, etc. The output format therefore can vary from interaction to interaction, depending on what parameters it is based on.

Indications

DrugBank’s structured indications provide a method of describing the uses of a drugs. Documentation is available for the indication and condition JSON objects.

Common Query Parameter Values

When specified, the parameters listed in the table below can be used with the following values:

Parameter Value Description
more null No effect - indications are returned based solely on the names of conditions.
more specific Include indications for more specific forms of the conditions matching the q parameter.
more general Include indications for more general forms of the conditions matching the q parameter.
off_label null No effect - indications will be returned regardless of off_label value.
off_label false Only labelled indications will be returned.
off_label true Only off-label indications will be returned.
kind blank Indications will be returned regardless of kind attribute.
kind single value Example: kind=treatment_of Only indications for which the kind attribute is “treatment_of” will be returned.
kind comma-delimted values Example: kind=treatment_of,management_of Only indications for which the kind attribute matches the provided values will be returned.
otc_use null No effect - indications will be returned regardless of otc_use value.
otc_use true Only indications for which the otc_use attribute is true will be returned.
otc_use false Only indications for which the otc_use attribute is false will be returned.

Search indications

curl -L 'https://api.drugbankplus.com/v1/indications?q=arthritis' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "kind": "symptomatic_treatment_of",
    "off_label": true,
    "otc_use": false,
    "route": [
      "Topical"
    ],
    "dose_form": [],
    "drug": {
      "name": "Chondroitin sulfate",
      "drugbank_id": "DB09301"
    },
    "condition": {
      "name": "Arthritis",
      "drugbank_id": "DBCOND0016433",
      "meddra_id": "llt/10003246",
      "snomed_id": "c/372091005",
      "icd10_id": "c/M19.90"
    }
  }
]

This endpoint searches for conditions, and then returns indications related to those conditions. Documentation is available for the indication and condition JSON objects.

This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/indications

Query Parameters

Parameter Default Description
q “” Text used to search conditions by name.
more null Determines how to broaden the condition search results. The original results will be included regardless of the value of this parameter.
off_label null Limits results by the value of the off_label attribute of the indications.
otc_use null Limits results by the value of the otc_use attribute of the indications.
kind null Limits results by the value of the kind attribute of the indications.
curl -L 'https://api.drugbankplus.com/v1/indications/drugs?q=arthritis' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drugbank_id": "DB09301",
    "name": "Chondroitin sulfate",
    "annotation_status": "complete",
    "availability_by_region": [
      {
        "region": "ca",
        "max_phase": 3,
        "marketed_prescription": false,
        "generic_available": false,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      {
        "region": "eu",
        "max_phase": 4,
        "marketed_prescription": false,
        "generic_available": false,
        "pre_market_cancelled": true,
        "post_market_cancelled": false
      },
      "..."
    ],
    "description": "Chondroitin sulfate is a glycosaminoglycan considered as a symptomatic slow-acting drug for osteoarthritis (SYSADOA)...",
    "simple_description": null,
    "clinical_description": null,
    "synonyms": [
      "Chondroitin sulfates",
      "Condroitín sulfato"
    ],
    "pharmacology": {
      "indication_descripton": "Chondroitin sulfate, used with glucosamine, is indicated to alleviate pain and inflammation from primary osteoarthritis...",
      "pharmacodynamic_description": "In clinical trials, chondroitin sulfate has been reported a significant pain relief...",
      "mechanism_of_action_description": "Chondroitin sulfate functions as a major component of the intricate extracellular matrix...",
      "absorption": "Chondroitin sulfate is absorbed from the gastrointestinal tract...",
      "protein_binding": "Chondroitin sulfate protein binding reports have shown a very low percentage of protein binding of only 0.23% of the total protein.[A32070]",
      "volume_of_distribution": [
        "After intramuscular administration of chondroitin sulfate, the apparent volume of distribution was 0..."
      ],
      "clearance": [],
      "half_life": "The approximate half-life of chondroitin sulfate and its derivative metabolites is 15 hours...",
      "route_of_elimination": "Chondroitin sulfate is excreted in the urine as intact polymers and as partial degradation products...",
      "toxicity_description": "Chondroitin sulfate does not present a carcinogenic potential..."
    },
    "food_interactions": [],
    "identifiers": {
      "drugbank_id": "DB09301",
      "inchi": null,
      "inchikey": null
    },
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT001272",
        "name": "Glycosaminoglycans",
        "mesh_id": "D006025",
        "mesh_tree_numbers": [
          "D09.698.373"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Mucopolysaccharides"
        ],
        "description": "Heteropolysaccharides which contain an N-acetylated hexosamine in a characteristic repeating disaccharide unit..."
      }
    ]
  }
]

This endpoint retrieves drugs based on a search of conditions and related indications. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/indications/drugs

This endpoint supports pagination.

URL Parameters

Parameter Default Description
q “” Text used to search conditions by name.
more null Determines how to broaden the condition search results. The original results will be included regardless of the value of this parameter.
off_label null Limits results by the value of the off_label attribute of the indications.
otc_use null Limits results by the value of the otc_use attribute of the indications.
kind null Limits results by the value of the kind attribute of the indications.

Query Parameters

Parameter Default Description
include_references false If true, includes the lists of references for each drug. See References for details.

Example: Search indications by condition and more specific forms

curl -L 'https://api.drugbankplus.com/v1/indications/drugs?q=autoimmune+disorders&more=specific' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drugbank_id": "DB00635",
    "name": "Prednisone",
    "annotation_status": "complete",
    "availability_by_region": [
      {
        "region": "ca",
        "max_phase": 4,
        "marketed_prescription": true,
        "generic_available": true,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      {
        "region": "eu",
        "max_phase": 4,
        "marketed_prescription": false,
        "generic_available": false,
        "pre_market_cancelled": true,
        "post_market_cancelled": false
      },
      "..."
    ],
    "description": "A synthetic anti-inflammatory glucocorticoid derived from cortisone. It is biologically inert and converted to prednisolone in the liver.",
    "simple_description": "A medication used to treat inflammation, immune reactions, hormone conditions, and abnormal cell growth.",
    "clinical_description": "A corticosteroid used to treat inflammation or immune-mediated reactions and to treat endocrine or neoplastic diseases.",
    "synonyms": [
      "1,2-Dehydrocortisone",
      "1,4-Pregnadiene-17α,21-diol-3,11,20-trione",
      "..."
    ],
    "pharmacology": {
      "indication_descripton": "For the treatment of drug-induced allergic reactions, perennial or seasonal allergic rhinitis, serum sickness, giant cell arteritis acute rheumatic or ...",
      "pharmacodynamic_description": "Prednisone, the most commonly-prescribed corticosteroid, is used to treat allograft rejection, asthma, systemic lupus erythematosus, and many other inf...",
      "mechanism_of_action_description": "Prednisone is a glucocorticoid receptor agonist...",
      "absorption": "Readily absorbed from the gastrointestinal tract...",
      "protein_binding": "Extensively bound to plasma proteins.",
      "volume_of_distribution": [],
      "clearance": [],
      "half_life": "Half life of both the immediate- and delayed- release formulation is 2 to 3 hours. ",
      "route_of_elimination": "Excreted in the urine as sulfate and glucuronide conjugates. ",
      "toxicity_description": ""
    },
    "food_interactions": [
      "Avoid alcohol.",
      "Avoid taking with grapefruit juice.",
      "..."
    ],
    "identifiers": {
      "drugbank_id": "DB00635",
      "inchi": "InChI=1S/C21H26O5/c1-19-7-5-13(23)9-12(19)3-4-14-15-6-8-21(26,17(25)11-22)20(15,2)10-16(24)18(14)19/h5,7,9,14-15,18,22,26H,3-4,6,8,10-11H2,1-2H3/t14-,1...",
      "inchikey": "XOFYZVNMUHMLCC-ZPOLXVRWSA-N"
    },
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000556",
        "name": "Adrenal Cortex Hormones",
        "mesh_id": "D000305",
        "mesh_tree_numbers": [
          "D06.472.040"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Hormones, Adrenal Cortex"
        ],
        "description": null
      },
      {
        "drugbank_id": "DBCAT003629",
        "name": "Adrenals",
        "mesh_id": null,
        "mesh_tree_numbers": [],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [],
        "description": null
      },
      "..."
    ]
  }
]

HTTP Request

GET https://api.drugbankplus.com/v1/indications?q=autoimmune+disorders&more=specific

Gets indications for items that match the search term, as well as any more specific terms. For instance, this could match indications for ‘autoimmune disorders’, as well as 'rheumatoid arthritis’, 'Celiac disease’, etc..

Conditions

Common Query Parameter Values

When specified, the parameters listed in the table below can be used with the following values:

Parameter Value Description
more null No effect - indications are returned based solely on the names of conditions.
more specific Include indications for more specific forms of the conditions matching the q parameter.
more general Include indications for more general forms of the conditions matching the q parameter.

Search conditions

curl -L 'https://api.drugbankplus.com/v1/ca/conditions?q=arthritis' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "name": "Arthritis",
    "drugbank_id": "DBCOND0016433",
    "uniprot_id": null,
    "meddra_id": "llt/10003246",
    "icd10_id": "c/M19.90",
    "snomed_id": "c/372091005"
  },
  {
    "name": "Reactive Arthritis",
    "drugbank_id": "DBCOND0033832",
    "uniprot_id": null,
    "meddra_id": "pt/10003267",
    "icd10_id": "c/M02.3",
    "snomed_id": "d/359278018"
  },
  "..."
]

This endpoint searches for conditions, and then returns indications related to those conditions. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/ca/conditions

Query Parameters

Parameter Default Description
q “” Text used to search conditions by name.
more null Determines how to broaden the condition search results. The original results will be included regardless of the value of this parameter.
exact false Determines how text results are matched. exact=true will not include partial matches such as ‘Rheumatoid Arthritis’ for the query 'arthritis’.

Get a condition

curl -L 'https://api.drugbankplus.com/v1/ca/conditions/DBCOND0015777' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "name": "Gout",
  "drugbank_id": "DBCOND0015777",
  "meddra_id": "llt/10018634",
  "snomed_id": "c/190827003",
  "icd10_id": "c/M10",
  "modification_of": {
    "base": {
      "name": "Gouty Arthritis",
      "drugbank_id": "DBCOND0052747",
      "meddra_id": "llt/10018634",
      "snomed_id": "c/190827003",
      "icd10_id": "c/M10"
    },
    "severity": {
      "includes": [
        "acute"
      ],
      "excludes": []
    }
  },
  "more_general": [
    {
      "name": "Disorders of purine metabolism",
      "drugbank_id": "DBCOND0027454",
      "meddra_id": "hlt/10070968",
      "snomed_id": "c/32612005"
    },
    {
      "name": "Purine and pyrimidine metabolism disorders",
      "drugbank_id": "DBCOND0027729",
      "meddra_id": "hlgt/10037546",
      "snomed_id": "c/238006008",
      "icd10_id": "c/E79"
    },
    "..."
  ],
  "more_specific": [
    {
      "name": "Gout Flares",
      "drugbank_id": "DBCOND0059958",
      "meddra_id": "llt/10064900",
      "snomed_id": "c/190844004",
      "icd10_id": "c/M10"
    },
    {
      "name": "Acute Gout Flare",
      "drugbank_id": "DBCOND0043190"
    },
    "..."
  ],
  "indications": [
    {
      "kind": "management_of",
      "off_label": false,
      "otc_use": false,
      "drug": {
        "name": "Cortisone acetate",
        "drugbank_id": "DB01380"
      },
      "regions": "US",
      "condition": {
        "name": "Acute Gouty Arthritis",
        "drugbank_id": "DBCOND0032167",
        "meddra_id": "llt/10018634",
        "snomed_id": "c/190827003",
        "icd10_id": "c/M10",
        "modification_of": {
          "base": {
            "name": "Gouty Arthritis",
            "drugbank_id": "DBCOND0052747",
            "meddra_id": "llt/10018634",
            "snomed_id": "c/190827003",
            "icd10_id": "c/M10"
          },
          "severity": {
            "includes": [
              "acute"
            ],
            "excludes": []
          }
        }
      }
    },
    {
      "kind": "management_of",
      "off_label": false,
      "otc_use": false,
      "drug": {
        "name": "Dexamethasone",
        "drugbank_id": "DB01234"
      },
      "regions": "US",
      "condition": {
        "name": "Acute Gouty Arthritis",
        "drugbank_id": "DBCOND0032167",
        "meddra_id": "llt/10018634",
        "snomed_id": "c/190827003",
        "icd10_id": "c/M10",
        "modification_of": {
          "base": {
            "name": "Gouty Arthritis",
            "drugbank_id": "DBCOND0052747",
            "meddra_id": "llt/10018634",
            "snomed_id": "c/190827003",
            "icd10_id": "c/M10"
          },
          "severity": {
            "includes": [
              "acute"
            ],
            "excludes": []
          }
        }
      }
    },
    "..."
  ]
}

URL Parameters

Parameter Description
ID The ID of the condition to retrieve.

Get indications linked to a condition

curl -L 'https://api.drugbankplus.com/v1/ca/conditions/DBCOND0015777/indications' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "kind": "management_of",
    "off_label": false,
    "otc_use": false,
    "drug": {
      "name": "Cortisone acetate",
      "drugbank_id": "DB01380"
    },
    "regions": "US",
    "condition": {
      "name": "Acute Gouty Arthritis",
      "drugbank_id": "DBCOND0032167",
      "meddra_id": "llt/10018634",
      "snomed_id": "c/190827003",
      "icd10_id": "c/M10",
      "modification_of": {
        "base": {
          "name": "Gouty Arthritis",
          "drugbank_id": "DBCOND0052747",
          "meddra_id": "llt/10018634",
          "snomed_id": "c/190827003",
          "icd10_id": "c/M10"
        },
        "severity": {
          "includes": [
            "acute"
          ],
          "excludes": []
        }
      }
    }
  },
  {
    "kind": "management_of",
    "off_label": false,
    "otc_use": false,
    "drug": {
      "name": "Dexamethasone",
      "drugbank_id": "DB01234"
    },
    "regions": "US",
    "condition": {
      "name": "Acute Gouty Arthritis",
      "drugbank_id": "DBCOND0032167",
      "meddra_id": "llt/10018634",
      "snomed_id": "c/190827003",
      "icd10_id": "c/M10",
      "modification_of": {
        "base": {
          "name": "Gouty Arthritis",
          "drugbank_id": "DBCOND0052747",
          "meddra_id": "llt/10018634",
          "snomed_id": "c/190827003",
          "icd10_id": "c/M10"
        },
        "severity": {
          "includes": [
            "acute"
          ],
          "excludes": []
        }
      }
    }
  },
  "..."
]

This endpoint retrieves indications linked to a condition.

HTTP Request

GET https://api.drugbankplus.com/v1/ca/conditions/<ID>/indications

URL Parameters

Parameter Description
ID The ID of the condition to retrieve.

Query Parameters

Parameter Default Description
more null Determines how to broaden the condition search results. The original results will be included regardless of the value of this parameter.
off_label null Limits results by the value of the off_label attribute of the indications.
otc_use null Limits results by the value of the otc_use attribute of the indications.
kind null Limits results by the value of the kind attribute of the indications.

This endpoint supports pagination.

Get product concepts linked to a condition

curl -L 'https://api.drugbankplus.com/v1/ca/conditions/DBCOND0015777/product_concepts' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "name": "Cortisone acetate",
    "display_name": null,
    "drugbank_pcid": "DBPC0013941",
    "brand": null,
    "level": 1,
    "route": null,
    "form": null,
    "strengths": null,
    "standing": "active",
    "standing_updated_at": "2018-09-12",
    "standing_active_since": "1951-12-31",
    "regions": {
      "us": true,
      "canada": true,
      "eu": false
    },
    "rxnorm_concepts": [
      {
        "name": "Cortisone",
        "RXCUI": "2878"
      },
      {
        "name": "cortisone acetate",
        "RXCUI": "21655"
      }
    ],
    "ingredients": [
      {
        "name": "Cortisone acetate",
        "drug": {
          "name": "Cortisone acetate",
          "drugbank_id": "DB01380"
        }
      }
    ]
  },
  {
    "name": "Dexamethasone",
    "display_name": null,
    "drugbank_pcid": "DBPC0002502",
    "brand": null,
    "level": 1,
    "route": null,
    "form": null,
    "strengths": null,
    "standing": "active",
    "standing_updated_at": "2018-09-12",
    "standing_active_since": "1958-10-30",
    "regions": {
      "us": true,
      "canada": true,
      "eu": true
    },
    "rxnorm_concepts": [
      {
        "name": "Dexamethasone",
        "RXCUI": "3264"
      }
    ],
    "ingredients": [
      {
        "name": "Dexamethasone",
        "drug": {
          "name": "Dexamethasone",
          "drugbank_id": "DB01234"
        }
      }
    ]
  },
  "..."
]

This endpoint retrieves product concepts linked to a condition.

HTTP Request

GET https://api.drugbankplus.com/v1/us/conditions/<ID>/product_concepts

URL Parameters

Parameter Description
ID The ID of the condition to retrieve.

Query Parameters

Parameter Default Description
more null Determines how to broaden the condition search results. The original results will be included regardless of the value of this parameter.
off_label null Limits results by the value of the off_label attribute of the indications used to find product concepts.
otc_use null Limits results by the value of the otc_use attribute of the indications used to find product concepts.
kind null Limits results by the value of the kind attribute of the indications used to find product concepts.
level The product concept level to filter by (optional).
min_level The minimum product concept level to return (optional).
min_level The maximum product concept level to return (optional).
unbranded_only false If true, returns only product concepts without an associated brand.

Get drugs linked to a condition via indications

curl -L 'https://api.drugbankplus.com/v1/ca/conditions/DBCOND0012160/drugs' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drugbank_id": "DB00825",
    "name": "Levomenthol",
    "annotation_status": "complete",
    "availability_by_region": [
      {
        "region": "ca",
        "max_phase": 4,
        "marketed_prescription": false,
        "generic_available": false,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      {
        "region": "eu",
        "max_phase": 4,
        "marketed_prescription": false,
        "generic_available": false,
        "pre_market_cancelled": true,
        "post_market_cancelled": false
      },
      "..."
    ],
    "description": "Menthol is a covalent organic compound made synthetically or obtained from peppermint or other mint oils...",
    "simple_description": "A medication used to treat mild to moderate muscle and joint pain.",
    "clinical_description": "An organic compound used to treat mild to moderate muscle and joint pain.",
    "synonyms": [
      "(-)-Menthol",
      "(−)-(1R,3R,4S)-menthol",
      "..."
    ],
    "pharmacology": {
      "indication_descripton": "Used to treat occasional minor irritation, pain, sore mouth, and sore throat as well as cough associated with a cold or inhaled irritants.",
      "pharmacodynamic_description": "Menthol is a covalent organic compound made synthetically or obtained from peppermint or other mint oils...",
      "mechanism_of_action_description": "Menthol primarily activates the cold-sensitive TRPM8 receptors in the skin...",
      "absorption": "",
      "protein_binding": "",
      "volume_of_distribution": [],
      "clearance": [],
      "half_life": "",
      "route_of_elimination": "",
      "toxicity_description": "Menthol, DL: ORAL (LD50): Acute: 2900 mg/kg [Rat], 3100 mg/kg [Mouse]. DERMAL (LD50): Acute: 5001 mg/kg [Rabbit]."
    },
    "food_interactions": [],
    "identifiers": {
      "drugbank_id": "DB00825",
      "inchi": "InChI=1S/C10H20O/c1-7(2)9-5-4-8(3)6-10(9)11/h7-11H,4-6H2,1-3H3/t8-,9+,10-/m1/s1",
      "inchikey": "NOOLISFMXDJSKH-KXUCPTDWSA-N"
    },
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT003297",
        "name": "Antiarrhythmic agents",
        "mesh_id": "D000889",
        "mesh_tree_numbers": [
          "D27.505.954.411.097"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Agents, Anti-Arrhythmia",
          "Agents, Antiarrhythmia",
          "..."
        ],
        "description": "Agents used for the treatment or prevention of cardiac arrhythmias..."
      },
      {
        "drugbank_id": "DBCAT000574",
        "name": "Calcium Channel Blockers",
        "mesh_id": "D002121",
        "mesh_tree_numbers": [
          "D27.505.519.562.249",
          "D27.505.696.260.500",
          "..."
        ],
        "atc_code": "C08",
        "atc_level": 2,
        "synonyms": [
          "Antagonists, Calcium Channel",
          "Antagonists, Exogenous Calcium",
          "..."
        ],
        "description": "A class of drugs that act by selective inhibition of calcium influx through cellular membranes..."
      },
      "..."
    ]
  },
  {
    "drugbank_id": "DB00586",
    "name": "Diclofenac",
    "annotation_status": "complete",
    "availability_by_region": [
      {
        "region": "ca",
        "max_phase": 4,
        "marketed_prescription": true,
        "generic_available": true,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      {
        "region": "eu",
        "max_phase": 4,
        "marketed_prescription": false,
        "generic_available": false,
        "pre_market_cancelled": true,
        "post_market_cancelled": false
      },
      "..."
    ],
    "description": "Diclofenac is a phenylacetic acid derivative and non-steroidal anti-inflammatory drug (NSAID)...",
    "simple_description": "A medication used to treat various types of arthritis.",
    "clinical_description": "An NSAID used to treat the signs and symptoms of osteoarthritis and rheumatoid arthritis.",
    "synonyms": [
      "[2-(2,6-dichloroanilino)phenyl]acetic acid",
      "2-((2,6-dichlorophenyl)amino)benzeneacetic acid",
      "..."
    ],
    "pharmacology": {
      "indication_descripton": "Diclofenac is indicated for use in the treatment of pain and inflammation from varying sources including inflammatory conditions such as osteoarthritis...",
      "pharmacodynamic_description": "Diclofenac reduces inflammation and by extension reduces nociceptive pain and combats fever...",
      "mechanism_of_action_description": "Diclofenac inhibits cyclooxygenase-1 and -2, the enzymes responsible for production of prostaglandin (PG) G<sub>2</sub> which is the precursor to other...",
      "absorption": "Diclofenac is completely absorbed from the GI tract but likely undergoes significant first pass metabolism with only 60% of the drug reaching systemic ...",
      "protein_binding": "Diclofenac is over 99...",
      "volume_of_distribution": [
        "Diclofenac has a total volume of distribution of 5-10 L or 0..."
      ],
      "clearance": [
        "Diclofenac has a plasma clearance 16 L/h.[A180694]"
      ],
      "half_life": "The terminal half-life of diclofenac is approximately 2 h, however the apparent half-life including all metabolites is 25.8-33 h.[label,A180694]",
      "route_of_elimination": "Diclofenac is mainly eliminated via metabolism...",
      "toxicity_description": "Symptoms of overdose include lethargy, drowsiness, nausea, vomiting, and epigastric pain, and gastrointestinal bleeding..."
    },
    "food_interactions": [
      "Avoid alcohol.",
      "Take with food to reduce irritation."
    ],
    "identifiers": {
      "drugbank_id": "DB00586",
      "inchi": "InChI=1S/C14H11Cl2NO2/c15-10-5-3-6-11(16)14(10)17-12-7-2-1-4-9(12)8-13(18)19/h1-7,17H,8H2,(H,18,19)",
      "inchikey": "DCOPUUMXTXDBNB-UHFFFAOYSA-N"
    },
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000046",
        "name": "Anti-Inflammatory Agents",
        "mesh_id": "D000893",
        "mesh_tree_numbers": [
          "D27.505.954.158"
        ],
        "atc_code": "V10A",
        "atc_level": 3,
        "synonyms": [
          "Agents, Anti Inflammatory",
          "Agents, Anti-Inflammatory",
          "..."
        ],
        "description": "Substances that reduce or suppress INFLAMMATION."
      },
      {
        "drugbank_id": "DBCAT000049",
        "name": "Anti-Inflammatory Agents, Non-Steroidal",
        "mesh_id": "D000894",
        "mesh_tree_numbers": [
          "D27.505.696.663.850.014.040.500",
          "D27.505.954.158.030",
          "..."
        ],
        "atc_code": "S01BC",
        "atc_level": 4,
        "synonyms": [
          "Agents, Aspirin-Like",
          "Agents, Non-Steroidal Anti-Inflammatory",
          "..."
        ],
        "description": "Anti-inflammatory agents that are non-steroidal in nature..."
      },
      "..."
    ]
  },
  "..."
]

This endpoint retrieves drugs linked to a condition via indications.

HTTP Request

GET https://api.drugbankplus.com/v1/ca/conditions/<ID>/drugs

URL Parameters

Parameter Description
ID The ID of the condition to retrieve.

Query Parameters

Parameter Default Description
more null Determines how to broaden the condition search results. The original results will be included regardless of the value of this parameter.
off_label null Limits results by the value of the off_label attribute of the indications used to find drugs.
otc_use null Limits results by the value of the otc_use attribute of the indications used to find drugs.
kind null Limits results by the value of the kind attribute of the indications used to find drugs.
include_references false If true, includes the lists of references for each drug. See References for details.

Get more general forms of a condition

curl -L 'https://api.drugbankplus.com/v1/ca/conditions/DBCOND0015777/general' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "name": "Disorders of purine metabolism",
    "drugbank_id": "DBCOND0027454",
    "meddra_id": "hlt/10070968",
    "snomed_id": "c/32612005"
  },
  {
    "name": "Purine and pyrimidine metabolism disorders",
    "drugbank_id": "DBCOND0027729",
    "meddra_id": "hlgt/10037546",
    "snomed_id": "c/238006008",
    "icd10_id": "c/E79"
  },
  "..."
]

This endpoint retrieves more general forms of a condition.

HTTP Request

GET https://api.drugbankplus.com/v1/ca/conditions/<ID>/general

URL Parameters

Parameter Description
ID The ID of the condition to retrieve.

Get more specific forms of a condition

curl -L 'https://api.drugbankplus.com/v1/ca/conditions/DBCOND0015777/specific' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "name": "Gout Flares",
    "drugbank_id": "DBCOND0059958",
    "meddra_id": "llt/10064900",
    "snomed_id": "c/190844004",
    "icd10_id": "c/M10"
  },
  {
    "name": "Gout flare",
    "drugbank_id": "DBCOND0023047",
    "meddra_id": "llt/10064900",
    "snomed_id": "c/190844004",
    "icd10_id": "c/M10"
  },
  "..."
]

This endpoint retrieves more specific forms of a condition.

HTTP Request

GET https://api.drugbankplus.com/v1/ca/conditions/<ID>/specific

URL Parameters

Parameter Description
ID The ID of the condition to retrieve.
curl -L 'https://api.drugbankplus.com/v1/ca/conditions/DBCOND0023821/references' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "name": "Inflammations",
    "drugbank_id": "DBCOND0024686",
    "meddra_id": "hlt/10021950",
    "snomed_id": "c/23583003"
  },
  {
    "name": "Pain",
    "drugbank_id": "DBCOND0012160",
    "meddra_id": "llt/10033470",
    "snomed_id": "c/279075009",
    "icd10_id": "c/R52"
  }
]

This endpoint retrieves related conditions.

HTTP Request

GET https://api.drugbankplus.com/v1/ca/conditions/<ID>/references

URL Parameters

Parameter Description
ID The ID of the condition to retrieve.

Categories

Common Category Query Parameter Values

When specified, the parameters listed in the table below can be used with the following values:

Parameter Value Description
include_children blank No effect.
include_children 1, 2 or 3 Include nested children to a depth of 1, 2, or 3.
include_parents blank No effect.
include_parents 1, 2 or 3 Include nested parents to a depth of 1, 2, or 3.
source blank or all Include children/parents from any hierarchy.
source atc Include children/parents from the ATC hierarchy.
source mesh Include children/parents from the MeSH hierarchy.

To limit the amount of data included, parent/child inclusion only goes outward from the categories being shown. I.E. include_parents=all&include_children=all will show all children and all parents of a category, not all children and all parents of all categories related categories. In other words, "parents": [] will not include "children": [] and vice-versa.

ATC and MeSH identifiers

Categories with equivalent entries in ATC and MeSH can be accessed by the identifiers used in ATC and MeSH, in addition to the DrugBank id assigned to those categories. In most cases below, examples of requests by ATC or MeSH identifier will be given without the response, as this would be the regardless of which identifier is used.

View Category

curl -L 'https://api.drugbankplus.com/v1/ca/categories/DBCAT001220' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "drugbank_id": "DBCAT001034",
  "name": "Xanthine derivatives",
  "mesh_id": "D013806",
  "mesh_tree_numbers": [
    "D03.132.960.751",
    "D03.633.100.759.758.824.751"
  ],
  "atc_code": "N06BC",
  "atc_level": 4,
  "categorization_kinds": [
    "therapeutic",
    "pharmacological",
    "..."
  ],
  "synonyms": [
    "1,3 Dimethylxanthine",
    "1,3-Dimethylxanthine",
    "..."
  ],
  "description": "A methyl xanthine derivative from tea with diuretic, smooth muscle relaxant, bronchial dilation, cardiac and central nervous system stimulant activitie..."
}

This endpoint retrieves a specific category based on DrugBank ID, ATC Code, or MeSH ID.

HTTP Request

GET https://api.drugbankplus.com/v1/us/categories/<ID>

GET https://api.drugbankplus.com/v1/us/categories/atc/<ATC_CODE>

GET https://api.drugbankplus.com/v1/us/categories/mesh/<MESH_ID>

URL Parameters

Parameter Description
ID The DrugBank ID of the category.
ATC_CODE The ATC Code of the category.
MESH_ID The unique MeSH identifier of the category.

View Category by ATC code

curl -L 'https://api.drugbankplus.com/v1/ca/categories/atc/L01' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "drugbank_id": "DBCAT000024",
  "name": "ANTINEOPLASTIC AGENTS",
  "mesh_id": "D000970",
  "mesh_tree_numbers": [
    "D27.505.954.248"
  ],
  "atc_code": "L01",
  "atc_level": 2,
  "categorization_kinds": [
    "therapeutic",
    "pharmacological",
    "..."
  ],
  "synonyms": [
    "Agents, Anticancer",
    "Agents, Antineoplastic",
    "..."
  ],
  "description": "Substances that inhibit or prevent the proliferation of NEOPLASMS."
}

This endpoint retrieves a specific category based on ATC Code.

HTTP Requests

GET https://api.drugbankplus.com/v1/us/categories/atc/<ATC_CODE>

URL Parameters

Parameter Description
ATC_CODE The ATC Code of the category to retrieve the parent categories.

View Category by MeSH Unique ID

curl -L 'https://api.drugbankplus.com/v1/ca/categories/mesh/D015122' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "drugbank_id": null,
  "name": "Mercaptopurine",
  "mesh_id": "D015122",
  "mesh_tree_numbers": [
    "D02.886.489.534",
    "D03.633.100.759.570"
  ],
  "atc_code": null,
  "atc_level": null,
  "categorization_kinds": [],
  "synonyms": [],
  "description": null
}

This endpoint retrieves a specific category based on MeSH Unique Identifier.

HTTP Requests

GET https://api.drugbankplus.com/v1/us/categories/mesh/<MESH_ID>/parents

URL Parameters

Parameter Description
MESH_ID The unique MeSH identifier of the category to retrieve the parent categories.

View Parents of a Category

curl -L 'https://api.drugbankplus.com/v1/ca/categories/DBCAT001220/parents?source=mesh&include_parents=3' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drugbank_id": null,
    "name": "Xanthines",
    "mesh_id": "D014970",
    "mesh_tree_numbers": [
      "D03.132.960",
      "D03.633.100.759.758.824"
    ],
    "atc_code": null,
    "atc_level": null,
    "categorization_kinds": [],
    "synonyms": [],
    "description": null,
    "parents": [
      {
        "drugbank_id": "DBCAT000443",
        "name": "Alkaloids",
        "mesh_id": "D000470",
        "mesh_tree_numbers": [
          "D03.132"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Alkaloids, Plant",
          "Plant Alkaloids"
        ],
        "description": "Organic nitrogenous bases...",
        "parents": [
          {
            "drugbank_id": "DBCAT000229",
            "name": "Heterocyclic Compounds",
            "mesh_id": "D006571",
            "mesh_tree_numbers": [
              "D03"
            ],
            "atc_code": null,
            "atc_level": null,
            "synonyms": [
              "Compounds, Heterocyclic"
            ],
            "description": "Ring compounds having atoms other than carbon in their nuclei. (Grant & Hackh's Chemical Dictionary, 5th ed)"
          }
        ]
      },
      {
        "drugbank_id": "DBCAT000504",
        "name": "Purinones",
        "mesh_id": "D011688",
        "mesh_tree_numbers": [
          "D03.633.100.759.758"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Oxopurines"
        ],
        "description": null,
        "parents": [
          {
            "drugbank_id": "DBCAT000253",
            "name": "Purines",
            "mesh_id": "D011687",
            "mesh_tree_numbers": [
              "D03.633.100.759"
            ],
            "atc_code": null,
            "atc_level": null,
            "synonyms": [],
            "description": "A series of heterocyclic compounds that are variously substituted in nature and are known also as purine bases...",
            "parents": [
              {
                "drugbank_id": "DBCAT000254",
                "name": "Heterocyclic Compounds, 2-Ring",
                "mesh_id": "D006574",
                "mesh_tree_numbers": [
                  "D03.633.100"
                ],
                "atc_code": null,
                "atc_level": null,
                "synonyms": [
                  "2-Ring Heterocyclic Compounds",
                  "Compounds, 2-Ring Heterocyclic",
                  "..."
                ],
                "description": "A class of organic compounds containing two ring structures, one of which is made up of more than one kind of atom, usually carbon plus another atom..."
              }
            ]
          }
        ]
      }
    ]
  }
]

Returns an array of categories which are parents of the specified category. Accepts the source parameter to limit relationships. By default this will return all parents.

This endpoint supports pagination.

HTTP Requests

GET https://api.drugbankplus.com/v1/us/categories/<ID>/parents

GET https://api.drugbankplus.com/v1/us/categories/atc/<ATC_CODE>/parents

GET https://api.drugbankplus.com/v1/us/categories/mesh/<MESH_ID>/parents

URL Parameters

Parameter Description
ID The DrugBank ID of the category to retrieve the child categories.
ATC_CODE The ATC Code of the category to retrieve the child categories.
MESH_ID The unique MeSH identifier of the category to retrieve the child categories.

View Children of a Category

curl -L 'https://api.drugbankplus.com/v1/ca/categories/DBCAT002118/children?source=atc' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drugbank_id": null,
    "name": "STOMATOLOGICAL PREPARATIONS",
    "mesh_id": null,
    "mesh_tree_numbers": [],
    "atc_code": "A01",
    "atc_level": 2,
    "categorization_kinds": [],
    "synonyms": [],
    "description": null
  },
  {
    "drugbank_id": "DBCAT002221",
    "name": "DRUGS FOR ACID RELATED DISORDERS",
    "mesh_id": null,
    "mesh_tree_numbers": [],
    "atc_code": "A02",
    "atc_level": 2,
    "categorization_kinds": [
      "indexing"
    ],
    "synonyms": [],
    "description": null
  },
  "..."
]

Returns an array of categories which are children of the specified category. Accepts the source parameter to limit relationships. By default this will return all parents.

This endpoint supports pagination.

HTTP Requests

GET https://api.drugbankplus.com/v1/us/categories/<ID>/children

GET https://api.drugbankplus.com/v1/us/categories/atc/<ATC_CODE>/children

GET https://api.drugbankplus.com/v1/us/categories/mesh/<MESH_ID>/children

URL Parameters

Parameter Description
ID The DrugBank ID of the category to retrieve the child categories.
ATC_CODE The ATC Code of the category to retrieve the child categories.
MESH_ID The unique MeSH identifier of the category to retrieve the child categories.

Get Drugs in a Category

curl -L 'https://api.drugbankplus.com/v1/us/categories/DBCAT001220/drugs' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drugbank_id": "DB14018",
    "name": "Bromotheophylline",
    "annotation_status": "complete",
    "availability_by_region": [
      {
        "region": "ca",
        "max_phase": 4,
        "marketed_prescription": false,
        "generic_available": true,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      {
        "region": "eu",
        "max_phase": 0,
        "marketed_prescription": false,
        "generic_available": false,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      "..."
    ],
    "description": "Bromotheophylline is the active moiety of pamabrom, a mixture of 2-amino-2-methyl-propanol and bromotheophylline...",
    "simple_description": null,
    "clinical_description": null,
    "synonyms": [
      "8-Bromotheophylline"
    ],
    "pharmacology": {
      "indication_descripton": "Bromotheophylline is used as a diuretic and also, in combination with [DB00316], it is used for the relief of temporary water weight gain, bloating, sw...",
      "pharmacodynamic_description": "Bromotheophylline diuretic action will produce an immediate increase in urination frequency...",
      "mechanism_of_action_description": "Bromotheophylline is part of the group of the xanthines...",
      "absorption": "When administered after one single oral dosage, bromotheophylline is rapidly absorbed and it reaches a maximal plasma concentration of 2...",
      "protein_binding": "This pharmacokinetic property has not been determined.",
      "volume_of_distribution": [
        "This pharmacokinetic property has not been determined."
      ],
      "clearance": [
        "This pharmacokinetic property has not been determined."
      ],
      "half_life": "The apparent elimination half-life is registered to be 21.35 hours.[L2743]",
      "route_of_elimination": "This pharmacokinetic property has not been determined.",
      "toxicity_description": "In overdose, bromotheophylline does not produce hepatic toxicity.[L2743]"
    },
    "food_interactions": [],
    "identifiers": {
      "drugbank_id": "DB14018",
      "inchi": "InChI=1S/C7H7BrN4O2/c1-11-4-3(9-6(8)10-4)5(13)12(2)7(11)14/h1-2H3,(H,9,10)",
      "inchikey": "SKTFQHRVFFOHTQ-UHFFFAOYSA-N"
    },
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000542",
        "name": "Diuretics",
        "mesh_id": "D004232",
        "mesh_tree_numbers": [
          "D27.505.696.560.500"
        ],
        "atc_code": "C03",
        "atc_level": 2,
        "synonyms": [
          "Diuretic Effect",
          "Diuretic Effects",
          "..."
        ],
        "description": "Agents that promote the excretion of urine through their effects on kidney function."
      },
      {
        "drugbank_id": "DBCAT001034",
        "name": "Xanthine derivatives",
        "mesh_id": "D013806",
        "mesh_tree_numbers": [
          "D03.132.960.751",
          "D03.633.100.759.758.824.751"
        ],
        "atc_code": "N06BC",
        "atc_level": 4,
        "synonyms": [
          "1,3 Dimethylxanthine",
          "1,3-Dimethylxanthine",
          "..."
        ],
        "description": "A methyl xanthine derivative from tea with diuretic, smooth muscle relaxant, bronchial dilation, cardiac and central nervous system stimulant activitie..."
      }
    ]
  }
]

Returns all drugs in this category.

This endpoint supports pagination.

HTTP Requests

GET https://api.drugbankplus.com/v1/us/categories/<ID>/drugs

GET https://api.drugbankplus.com/v1/us/categories/atc/<ATC_CODE>/drugs

GET https://api.drugbankplus.com/v1/us/categories/mesh/<MESH_ID>/drugs

URL Parameters

Parameter Description
ID The DrugBank ID of the category to retrieve the linked drugs.
ATC_CODE The ATC Code of the category to retrieve the linked drugs.
MESH_ID The unique MeSH identifier of the category to retrieve the linked drugs.

Query Parameters

Parameter Default Description
include_references false If true, includes the lists of references for each drug. See References for details.

Search Category Names / Autocomplete

curl -L 'https://api.drugbankplus.com/v1/category_names?q=antimetabolites' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "categories": [
    {
      "hits": [
        {
          "field": "name",
          "value": "<em>Antimetabolites</em>, Antineoplastic"
        },
        {
          "field": "synonyms",
          "value": "Antineoplastic <em>Antimetabolites</em>"
        }
      ],
      "drugbank_id": "DBCAT000685",
      "name": "Antimetabolites, Antineoplastic",
      "mesh_id": "D000964",
      "mesh_tree_numbers": [
        "D27.505.519.186.144",
        "D27.505.954.248.144",
        "..."
      ],
      "atc_code": null,
      "atc_level": null,
      "categorization_kinds": [
        "indexing"
      ],
      "synonyms": [
        "Antineoplastic Antimetabolites"
      ],
      "description": "Antimetabolites that are useful in cancer chemotherapy."
    },
    {
      "hits": [
        {
          "field": "name",
          "value": "<em>Antimetabolites</em>"
        }
      ],
      "drugbank_id": "DBCAT000276",
      "name": "Antimetabolites",
      "mesh_id": "D000963",
      "mesh_tree_numbers": [
        "D27.505.519.186",
        "D27.888.569.042"
      ],
      "atc_code": "L01B",
      "atc_level": 3,
      "categorization_kinds": [
        "therapeutic",
        "indexing"
      ],
      "synonyms": [],
      "description": "Drugs that are chemically similar to naturally occurring metabolites, but differ enough to interfere with normal metabolic pathways..."
    }
  ]
}

This endpoint returns a list of categories suitable for use with autocomplete forms, for quickly finding the right categories. Note that this search is for DrugBank categories and will not include results for ATC or Mesh categories that don’t map to a corresponding DrugBank category.

This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/category_names

Query Parameters

Parameter Default Description
q null The string you want to search with.
fuzzy false If set to true, enable fuzzy search (see fuzzy searching below).

Notice the hits array returned in the results. The hits contain highlighted snippets from the match. You can use these highlights in autocomplete applications. The matching part of the text is wrapped in an <em> tag, which you can style as you wish in your application.

Fuzzy Searching

This example demonstrates a misspelling of “Antimetabolite”, with fuzzy search enabled you will still get a result (try it yourself!).

curl -L 'https://api.drugbankplus.com/v1/category_names?q=aantimetabolites&fuzzy=true' 
-H 'Authorization: mytoken'

Fuzzy searching allows for misspellings, but is not enabled by default, you must set fuzzy=true. By setting fuzzy=true you are telling the API to allow a certain number of misspellings to still count as a match (defaults to 2). You can also pass a number of misspellings in to increase the likelyhood of a match (for example, fuzzy=4 will allow 4 misspelled letters).

Adverse Effects

Common Query Parameter Values

When specified, the parameters listed in the table below can be used with the following values:

Parameter Value Description
more null No effect - adverse effects are returned based solely on the names of conditions.
more specific Include adverse effects for more specific forms of the conditions matching the q parameter.
more general Include adverse effects for more general forms of the conditions matching the q parameter.

Search adverse effects

curl -L 'https://api.drugbankplus.com/v1/us/adverse_effects?q=cardiac' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drug": {
      "name": "Tacrolimus",
      "drugbank_id": "DB00864"
    },
    "evidence_type": [
      "clinical_trial"
    ],
    "regions": "US",
    "incidences": [
      {
        "kind": "experimental",
        "name": "tacrolimus/MMF",
        "percent": "89%"
      }
    ],
    "effect": {
      "name": "Hypertension",
      "drugbank_id": "DBCOND0020037",
      "meddra_id": "llt/10020800",
      "snomed_id": "c/266287006",
      "icd10_id": "c/I10"
    },
    "patient_characteristics": [
      {
        "name": "Heart Transplant",
        "drugbank_id": "DBCOND0037477",
        "meddra_id": "llt/10019314",
        "snomed_id": "c/149204008"
      }
    ]
  }
]

This endpoint searches for conditions, and then returns adverse effects related to those conditions. This endpoint supports pagination.

HTTP Request

GET https://api.drugbankplus.com/v1/us/adverse_effects

Query Parameters

Parameter Default Description
q “” Text used to search conditions by name.
more null Determines how to broaden the condition search results. The original results will be included regardless of the value of this parameter.
exact false Determines how text results are matched. exact=true will not include partial matches such as ‘Rheumatoid Arthritis’ for the query 'arthritis’.

Get drugs linked to an adverse effect condition

curl -L 'https://api.drugbankplus.com/v1/us/adverse_effects/DBCOND0020133/drugs' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "drugbank_id": "DB01003",
    "name": "Cromoglicic acid",
    "annotation_status": "complete",
    "availability_by_region": [
      {
        "region": "ca",
        "max_phase": 4,
        "marketed_prescription": true,
        "generic_available": true,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      {
        "region": "eu",
        "max_phase": 4,
        "marketed_prescription": false,
        "generic_available": false,
        "pre_market_cancelled": true,
        "post_market_cancelled": false
      },
      "..."
    ],
    "description": "A chromone complex that acts by inhibiting the release of chemical mediators from sensitized mast cells...",
    "simple_description": "A medication used to treat asthma, allergies of the eyes and nose, and other allergic reactions.",
    "clinical_description": "A medication used to treat asthma, allergic reactions of the eyes and nose, as well as other mast cell reactions.",
    "synonyms": [
      "5-[3-(2-carboxy-4-oxo-4H-5-chromenyloxy)-2-hydroxypropoxy]-4-oxo-4H-2-chromenecarboxylic acid",
      "Acide Cromoglicique",
      "..."
    ],
    "pharmacology": {
      "indication_descripton": "For the management of patients with bronchial asthma...",
      "pharmacodynamic_description": "Cromoglicate or cromolyn (USAN), a synthetic compound, inhibits antigen-induced bronchospasms and, hence, is used to treat asthma and allergic rhinitis...",
      "mechanism_of_action_description": "Cromoglicate inhibits degranulation of mast cells, subsequently preventing the release of histamine and slow-reacting substance of anaphylaxis (SRS-A),...",
      "absorption": "1%",
      "protein_binding": "",
      "volume_of_distribution": [],
      "clearance": [],
      "half_life": "1.3 hours",
      "route_of_elimination": "",
      "toxicity_description": "Symptoms of overdose include cough, nasal congestion, nausea, sneezing and wheezing."
    },
    "food_interactions": [],
    "identifiers": {
      "drugbank_id": "DB01003",
      "inchi": "InChI=1S/C23H16O11/c24-11(9-31-14-3-1-5-16-20(14)12(25)7-18(33-16)22(27)28)10-32-15-4-2-6-17-21(15)13(26)8-19(34-17)23(29)30/h1-8,11,24H,9-10H2,(H,27,2...",
      "inchikey": "IMZMKUWMOSJXDT-UHFFFAOYSA-N"
    },
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000133",
        "name": "Anti-Allergic Agents",
        "mesh_id": "D018926",
        "mesh_tree_numbers": [
          "D27.505.954.016"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Agents, Anti-Allergic",
          "Agents, Antiallergic",
          "..."
        ],
        "description": "Agents that are used to treat allergic reactions..."
      },
      {
        "drugbank_id": "DBCAT002745",
        "name": "Mast Cell Stabilizers",
        "mesh_id": null,
        "mesh_tree_numbers": [],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [],
        "description": null
      },
      "..."
    ]
  }
]

This endpoint retrieves drugs linked to a condition via adverse effects.

HTTP Request

GET https://api.drugbankplus.com/v1/us/adverse_effects/<ID>/drugs

URL Parameters

Parameter Description
ID The ID of the condition to retrieve.

Query Parameters

Parameter Default Description
more null Determines how to broaden the condition search results. The original results will be included regardless of the value of this parameter.
include_references false If true, includes the lists of references for each drug. See References for details.

Get products linked to an adverse effect condition

curl -L 'https://api.drugbankplus.com/v1/us/adverse_effects/DBCOND0020133/products' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

[
  {
    "ndc_product_code": "00781-9158",
    "dpd_id": null,
    "ema_product_code": null,
    "ema_ma_number": null,
    "name": "Bivalirudin",
    "prescribable_name": "Bivalirudin 250 mg Injection",
    "rx_norm_prescribable_name": "bivalirudin 250 MG Injection",
    "started_marketing_on": "2015-10-23",
    "ended_marketing_on": null,
    "approved_on": null,
    "schedule": null,
    "dosage_form": "Injection, powder, lyophilized, for solution",
    "route": "Intravenous",
    "application_number": "NDA020873",
    "generic": true,
    "otc": false,
    "approved": true,
    "country": "US",
    "mixture": false,
    "ingredients": [
      {
        "name": "Bivalirudin",
        "drugbank_id": "DB00006",
        "strength": {
          "number": "250",
          "unit": "mg/1"
        }
      }
    ],
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000007",
        "name": "Anticoagulants",
        "mesh_id": "D000925",
        "mesh_tree_numbers": [
          "D27.505.954.502.119"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Agents, Anticoagulant",
          "Anti-coagulant",
          "..."
        ],
        "description": "Agents that prevent clotting."
      },
      {
        "drugbank_id": "DBCAT000012",
        "name": "Antithrombins",
        "mesh_id": "D000991",
        "mesh_tree_numbers": [
          "D27.505.519.389.745.800.449",
          "D27.505.954.502.119.500"
        ],
        "atc_code": "B01AE",
        "atc_level": 4,
        "synonyms": [
          "Antithrombins, Direct",
          "Direct Antithrombins",
          "..."
        ],
        "description": "Endogenous factors and drugs that directly inhibit the action of THROMBIN, usually by blocking its enzymatic activity..."
      }
    ],
    "labeller": {
      "name": "Sandoz"
    },
    "images": []
  }
]

This endpoint retrieves products linked to a condition via adverse effects.

HTTP Request

GET https://api.drugbankplus.com/v1/us/adverse_effects/<ID>/products

URL Parameters

Parameter Description
ID The ID of the condition to retrieve.

Query Parameters

Parameter Default Description
more null Determines how to broaden the condition search results. The original results will be included regardless of the value of this parameter.

Packages

Get a specific U.S. package

curl -L 'https://api.drugbankplus.com/v1/us/packages/50580-111-08' 
-H 'Authorization: mytoken'

Example command returns JSON structured like this (results may be abbreviated):

{
  "package_ndc_code": "50580-0111-08",
  "description": "240 mL in 1 BOTTLE, PLASTIC",
  "amount": "240",
  "unit": "mL",
  "form": "BOTTLE, PLASTIC",
  "for_product": {
    "ndc_product_code": "50580-0111",
    "name": "Tylenol Extra Strength",
    "active_ingredients": [
      {
        "name": "Acetaminophen",
        "unii": "362O9ITL9D",
        "strength_number": "500",
        "strength_unit": "mg/15mL"
      }
    ],
    "inactive_ingredients": [
      {
        "name": "anhydrous citric acid",
        "unii": "XF417D3PSL",
        "strength_number": null,
        "strength_unit": null
      },
      {
        "name": "D&C Red NO. 33",
        "unii": "9DBA0SBB0L",
        "strength_number": null,
        "strength_unit": null
      },
      "..."
    ]
  },
  "packaging_tree": [
    {
      "package_ndc_code": "50580-0111-08",
      "description": "240 mL in 1 BOTTLE, PLASTIC",
      "amount": "240",
      "unit": "mL",
      "form": "BOTTLE, PLASTIC"
    }
  ]
}

Some packages contain multiple levels, shown in the packaging_tree attribute:

{
    "package_ndc_code": "75834-0130-84",
    "description": "28 in 1 BLISTER PACK",
    "amount": "28",
    "unit": "1",
    "form": "BLISTER PACK",
    "for_product": {
      "name": "..."
    },
    "packaging_tree": [
        {
            "package_ndc_code": "75834-0130-29",
            "description": "3 in 1 CARTON",
            "amount": "3",
            "unit": "1",
            "form": "CARTON",
            "content": {
                "package_ndc_code": "75834-0130-84",
                "description": "28 in 1 BLISTER PACK",
                "amount": "28",
                "unit": "1",
                "form": "BLISTER PACK"
            }
        }
    ]
}

Some packages are kits containing multiple parts. In this case the returning JSON will contain a parts array:

{
    "package_ndc_code": "68405-0018-06",
    "description": "1 in 1 KIT",
    "amount": "1",
    "unit": "1",
    "form": "KIT",
    "for_product": {
        "name": "..."
    },
    "parts": [
        {
            "number": 1,
            "ndc_product_code": "52959-0190",
            "name": "NAPROXEN",
            "route": "ORAL",
            "amount": "60",
            "unit": "1",
            "dosage_form": "TABLET",
            "marketing_category": "ANDA",
            "application_number": "ANDA075927",
            "packaging_tree": [
                {
                    "package_ndc_code": "52959-0190-30",
                    "description": "60 in 1 BOTTLE",
                    "amount": "60",
                    "unit": "1",
                    "form": "BOTTLE"
                }
            ],
            "active_ingredients": [
                {
                    "name": "NAPROXEN",
                    "unii": "57Y76R9ATQ",
                    "strength_number": "250",
                    "strength_unit": "mg/1"
                }
            ],
            "inactive_ingredients": [
                {
                    "name": "CROSCARMELLOSE SODIUM",
                    "unii": "M28OL1HH48",
                    "strength_number": null,
                    "strength_unit": null
                },
                {
                    "name": "POVIDONE",
                    "unii": "FZ989GH94E",
                    "strength_number": null,
                    "strength_unit": null
                },
                {
                    "name": "MAGNESIUM STEARATE",
                    "unii": "70097M6I30",
                    "strength_number": null,
                    "strength_unit": null
                }
            ]
        },
        {
            "number": 2,
            "ndc_product_code": null,
            "name": "Theramine",
            "route": "ORAL",
            "amount": "90",
            "unit": "1",
            "dosage_form": "CAPSULE",
            "marketing_category": "MEDICAL FOOD",
            "application_number": null,
            "packaging_tree": [
                {
                    "package_ndc_code": null,
                    "description": "90 in 1 BOTTLE",
                    "amount": "90",
                    "unit": "1",
                    "form": "BOTTLE"
                }
            ],
            "active_ingredients": [
                {
                    "name": ".GAMMA.-AMINOBUTYRIC ACID",
                    "unii": "2ACZ6IPC6I",
                    "strength_number": "100",
                    "strength_unit": "mg/1"
                }
            ],
            "inactive_ingredients": [
                {
                    "name": "MAGNESIUM STEARATE",
                    "unii": "70097M6I30",
                    "strength_number": null,
                    "strength_unit": null
                },
                {
                    "name": "CELLULOSE, MICROCRYSTALLINE",
                    "unii": "OP1R32D61U",
                    "strength_number": null,
                    "strength_unit": null
                },
                {
                    "name": "MALTODEXTRIN",
                    "unii": "7CVR7L4A2D",
                    "strength_number": null,
                    "strength_unit": null
                },
                {
                    "name": "GELATIN",
                    "unii": "2G86QN327L",
                    "strength_number": null,
                    "strength_unit": null
                }
            ]
        }
    ],
    "packaging_tree": [
        {
            "package_ndc_code": "68405-0018-06",
            "description": "1 in 1 KIT",
            "amount": "1",
            "unit": "1",
            "form": "KIT"
        }
    ]
}

A package that is found in kits will have a part_of array to reference the kits. Some packages are only found in kits; those packages will have a for_part attribute in place of the for_product attribute:

{
    "package_ndc_code": "52959-0190-30",
    "description": "60 in 1 BOTTLE",
    "amount": "60",
    "unit": "1",
    "form": "BOTTLE",
    "for_part": {
        "ndc_product_code": "52959-0190",
        "name": "NAPROXEN",
        "active_ingredients": [
            {
                "name": "NAPROXEN",
                "unii": "57Y76R9ATQ",
                "strength_number": "250",
                "strength_unit": "mg/1"
            }
        ],
        "inactive_ingredients": [
            {
                "name": "CROSCARMELLOSE SODIUM",
                "unii": "M28OL1HH48",
                "strength_number": null,
                "strength_unit": null
            },
            {
                "name": "POVIDONE",
                "unii": "FZ989GH94E",
                "strength_number": null,
                "strength_unit": null
            },
            {
                "name": "MAGNESIUM STEARATE",
                "unii": "70097M6I30",
                "strength_number": null,
                "strength_unit": null
            }
        ]
    },
    "packaging_tree": [
        {
            "package_ndc_code": "52959-0190-30",
            "description": "60 in 1 BOTTLE",
            "amount": "60",
            "unit": "1",
            "form": "BOTTLE"
        }
    ],
    "part_of": [
        {
            "package_ndc_code": "68405-0018-06",
            "description": "1 in 1 KIT",
            "product": {
                "ndc_product_code": "68405-0018",
                "name": "Theraproxen-90"
            }
        },
        {
            "package_ndc_code": "68405-0016-36",
            "description": "1 in 1 KIT",
            "product": {
                "ndc_product_code": "68405-0016",
                "name": "Trepoxen-250"
            }
        },
        {
            "package_ndc_code": "68405-0180-06",
            "description": "1 in 1 KIT",
            "product": {
                "ndc_product_code": "68405-0180",
                "name": "Theraproxen"
            }
        }
    ]
}

This endpoint retrieves a specific package based on NDC ID.

HTTP Request

GET https://api.drugbankplus.com/v1/us/products/<NDC_ID>

URL Parameters

Parameter Description
ID The NDC ID of the package to retrieve.

References

An example of the structure of a reference list:

{
  "references": {
    "literature_references": [
      {
        "ref_id": "A463",
        "pubmed_id": 15879007,
        "citation": "Kis B, Snipes JA, Busija DW: Acetaminophen and the cyclooxygenase-3 puzzle: sorting out facts, fictions, and uncertainties. J Pharmacol Exp Ther. 2005 Oct;315(1):1-7. Epub 2005 May 6."
      },
      {
        "ref_id": "A464",
        "pubmed_id": 16413237,
        "citation": "Aronoff DM, Oates JA, Boutaud O: New insights into the mechanism of action of acetaminophen: Its clinical pharmacologic characteristics reflect its inhibition of the two prostaglandin H2 synthases. Clin Pharmacol Ther. 2006 Jan;79(1):9-19."
      }
    ],
    "textbooks": [
      {
        "ref_id": "T518",
        "isbn": null,
        "citation": "Valerie Gerriets; Thomas M. Nappe (2019). Acetaminophen. StatPearls publishing."
      }
    ],
    "external_links": [
      {
        "ref_id": "L5756",
        "title": "Acetaminophen tablet, DailyMed",
        "url": "https://dailymed.nlm.nih.gov/dailymed/drugInfo.cfm?setid=c3b408ff-f47b-4fee-ade5-5db6e25f4ee0"
      },
      {
        "ref_id": "L5774",
        "title": "Acetaminophen effervescent tablets, Cleveland Clinic",
        "url": "https://my.clevelandclinic.org/health/drugs/18282-acetaminophen-effervescent-tablets"
      }
    ],
    "attachments": [
      {
        "ref_id": "F4124",
        "title": "Acetaminophen monograph, suppository",
        "url": "//s3-us-west-2.amazonaws.com/drugbank-qa/cite_this/attachments/files/000/004/124/original/Acetaminophen_monograph__suppository.pdf?1553636652"
      }
    ]
  }
}

Certain fields, such as drug descriptions and drug-drug interaction descriptions, include citations within the text. These citations are in the format:

[<letter><number>]

Where the letter indicates the source type of the citation and the number is the identifier (e.g. [A001]). The citation source types are listed below:

Letter Type
A Literature article
T Textbook
L External link
F File attachment

The corresponding citation details can be returned within the JSON object by including include_references=true as a parameter in the URL.

API Versions

Accessing API versions

All previous versions of our API documentation are available:

Version Link Released
v0 https://docs.drugbankplus.com/v0 July, 2016
v1 https://docs.drugbankplus.com/v1 September, 2016 (Current)

You can access the latest version of the API docs using the base docs url:

https://docs.drugbankplus.com

This will redirect you to the newest version of the API.