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 region

The DrugBank API is optionally filtered by region or regions of availability. 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 filter, 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.drugbank.com/v1/drug_names?region=ca&q=abacavir

To search for available drug products by name in Canada or the United States, you would use the following URL:

https://api.drugbank.com/v1/drug_names?region=ca,us&q=abacavir

The currently available regions are:

Region	Region code
Austria	at
Canada	ca
Colombia	co
European Union	eu
Indonesia	idn
Italy	it
Malaysia	my
Singapore	sg
Thailand	th
Turkey	tr
United States	us

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

Authentication

To authorize, use this code:

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

Make sure to replace myapikey with your development or production API key.

DrugBank uses API keys to allow access to the API. To request an API key please 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: myapikey

Production Key

Your production key is the authentication token you receive upon sign up. This key does not have a limit in regards to the amount of calls you can make. Any API calls that exceed your quota (if applicable) will be permitted but counted as overage.

Development Key

A development key is a second API key which, unlike the production key, caps the number of allowed requests at 3000 requests/month.

The request limit is to meant to prevent runwaway programs from making calls that exceed your expected usage during the development process. The development key should be kept secret and only be shared with your developers in order to ensure that if a mistake happens during programming, it can be fixed without affecting the production key.

Token Authentication

To get a token that expires in 12 hours, use this code:

curl -L -X POST 'https://api.drugbank.com/v1/tokens' \ 
-H 'Content-Type: application/json' \ 
-H 'Authorization: myapikey' \ 
-H 'Cache-Control: no-cache' -d '{
  "ttl": 12
}'

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

{
  "token": "eyJhbGciOiJIUzI1NiJ9.eyJrZXlfaWQiOjk5MiwiZXhwIjoxNjU1MzI5Mjc5fQ.v0ZZJtwujnojW8K-nDIIEgrjICFOVmt8FanSgbw7120"
}

The following will request a token that expires in 15 minutes:

curl -L -X POST 'https://api.drugbank.com/v1/tokens' \ 
-H 'Content-Type: application/json' \ 
-H 'Authorization: myapikey' \ 
-H 'Cache-Control: no-cache' -d '{
  "ttl": "15m"
}'

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

{
  "token": "eyJhbGciOiJIUzI1NiJ9.eyJrZXlfaWQiOjk5MiwiZXhwIjoxNjU1MzI5Mjc5fQ.v0ZZJtwujnojW8K-nDIIEgrjICFOVmt8FanSgbw7120"
}

To authorize a request using an API token, use this code:

curl -L 'https://api.drugbank.com/v1/endpoint' 
-H 'Authorization: Bearer mytoken'

To authorize a browser-based request using an API token, use this code:

const xhr = new XMLHttpRequest();
const url = 'https://api-js.drugbank.com/v1/endpoint';

xhr.open('GET', url);
xhr.setRequestHeader('Authorization', 'Bearer mytoken');
xhr.send();

Alternatively you can use tokens to get access to the DrugBank APIs. Tokens allow short term access to DrugBank API without exposing your secret API key. They are guaranteed to expire within 24 hours. The use of token authentication is required for accessing DrugBank APIs from browser-based applications.

Token life time

The default expiry of a token is 24 hours after it was created. The lifetime of a token can be set with the ttl parameter on creation. When set, the ttl is the number of hours the token is valid for, with a maximum of 24 hours. If no unit is given, the ttl is assumed to be in hours. The value can also be sent as a string with a unit attached (“m” for minutes or “h” for hours). A ttl of “15m” will request a token that expires in 15 minutes.

Web browser-based application API authentication

Web browser-based applications are permitted to access the DrugBank APIs through:

https://api-js.drugbank.com

All API calls, as described in this documentation, are identical – with the exception of the web address and the authentication method. Token based authentication is required to access the web compatible API.

It is recommend that tokens for use in your web browser-based applications are generated from an internal service that you can authenticate your users against. This way your secret key is not exposed and you can control who has access to your DrugBank subscription.

Pagination

curl -L 'https://api.drugbank.com/v1/drugs?page=2' 
-H 'Authorization: myapikey' -v

...
< Link: <https://api.drugbank.com/v1/drugs?page=3&per_page=50>; rel="next",https://api.drugbank.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 outside of 1-50 will result in a Bad Request error.
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
403	Rate Limit Exceeded – The API is rate limited to 100 requests per second, per client. Try again later.
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
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.drugbank.com/v1/drugs.json' 
-H 'Authorization: myapikey'

curl -L 'https://api.drugbank.com/v1/drugs' 
-H 'Authorization: myapikey' -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.drugbank.com/v1/ddi" \
-H "Content-Type: application/json" \
-H 'Authorization: myapikey' \
-H "Cache-Control: no-cache" -d '{
  "ndc": ["0143-9503", "0056-0173"],
  "drugbank_id": ["DB00503", "DB01221", "DB00331", "DB00819"],
  "product_concept_id": ["DBPC0024484", "DBPC0085378"]
}'

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

Request Headers

Header	Description
Content-Type	MIME type of request body.

Drug Search / Autocomplete

Medication Search Plugin

Our medication search plugin provides a “plug and play” alternative to implementing our medication name search endpoint:

As a standard web component, it is easy to integrate and style to suit your needs and comes with a number of available properties to fine-tune its functionality. This plugin can be used together with our Drug-Drug Interactions Plugin. For more information, please see this public repository.

Medication Name Search

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

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

[
  {
    "hits": [
      {
        "value": "<em>Acetamino</em>phen"
      },
      {
        "value": "<em>ACETAMINO</em>FEN JARABE"
      }
    ],
    "detailed_hits": [
      {
        "field": "title",
        "matches": [
          "<em>Acetamino</em>phen"
        ],
        "match_highlight_name": "<em>Acetamino</em>phen"
      },
      {
        "field": "ingredients",
        "matches": {
          "DB00316": [
            "<em>Acetamino</em>phen"
          ]
        },
        "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,
      "germany": true,
      "colombia": true,
      "turkey": true,
      "italy": true,
      "malaysia": true,
      "austria": true,
      "indonesia": true,
      "thailand": true,
      "singapore": true
    },
    "rxnorm_concepts": [
      {
        "name": "acetaminophen",
        "RXCUI": "161"
      }
    ],
    "ingredients": [
      {
        "name": "Acetaminophen",
        "drug": {
          "name": "Acetaminophen",
          "drugbank_id": "DB00316"
        }
      }
    ]
  }
]

Medication name search allows you to quickly search for product concepts. Like the most of the DrugBank API, the returned concepts can be filtered by region using a the region parameter like /v1/product_concepts?region=us.

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.drugbank.com/v1/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”).

Drug Name Search

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

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

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

{
  "products": [
    {
      "hits": [
        {
          "field": "name",
          "value": "<em>Viagra</em>"
        },
        {
          "field": "prescribable_name",
          "value": "Sildenafil 50 mg Oral Tablet [<em>Viagra</em>]"
        }
      ],
      "name": "Viagra",
      "prescribable_name": "Sildenafil 50 mg Oral Tablet [Viagra]",
      "country": "EU",
      "ndc_product_codes": null,
      "dpd_codes": null,
      "ema_product_codes": [
        "EMEA/H/C/000202"
      ],
      "ema_ma_numbers": [
        "EU/1/98/077/006",
        "EU/1/98/077/007",
        "..."
      ],
      "pzns": [],
      "co_product_ids": [],
      "tr_product_ids": [],
      "it_product_ids": [],
      "my_product_ids": [],
      "at_product_ids": [],
      "idn_product_ids": [],
      "th_product_ids": [],
      "sg_product_ids": [],
      "dosage_form": "Tablet, film coated",
      "strength": {
        "number": "50",
        "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": "50",
            "unit": "mg"
          }
        }
      ],
      "images": []
    },
    {
      "hits": [
        {
          "field": "name",
          "value": "<em>VIAGRA</em>"
        },
        {
          "field": "prescribable_name",
          "value": "Sildenafil 25 mg Oral Tablet [<em>Viagra</em>]"
        }
      ],
      "name": "VIAGRA",
      "prescribable_name": "Sildenafil 25 mg Oral Tablet [Viagra]",
      "country": "Italy",
      "ndc_product_codes": null,
      "dpd_codes": null,
      "ema_product_codes": null,
      "ema_ma_numbers": null,
      "pzns": [],
      "co_product_ids": [],
      "tr_product_ids": [],
      "it_product_ids": [
        "034076024",
        "034076036",
        "..."
      ],
      "my_product_ids": [],
      "at_product_ids": [],
      "idn_product_ids": [],
      "th_product_ids": [],
      "sg_product_ids": [],
      "dosage_form": "Tablet",
      "strength": {
        "number": "25",
        "unit": "MG"
      },
      "route": "Oral",
      "approved": false,
      "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.drugbank.com/v1/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.

Prescribable Name Search

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

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

{
  "products": [
    {
      "hits": [
        {
          "field": "name",
          "value": "Cilostazol 100 mg Tablet [<em>Viagra</em>]"
        }
      ],
      "name": "Cilostazol 100 mg Tablet [Viagra]",
      "country": "Thailand",
      "brands": [
        "VIAGRA ( TABLETS 50 MG)"
      ],
      "ndc_product_codes": null,
      "dpd_codes": null,
      "ema_product_codes": null,
      "ema_ma_numbers": null,
      "pzns": [],
      "co_product_ids": [],
      "tr_product_ids": [],
      "it_product_ids": [],
      "my_product_ids": [],
      "at_product_ids": [],
      "idn_product_ids": [],
      "th_product_ids": [
        "1C 120/47(N)"
      ],
      "sg_product_ids": [],
      "dosage_forms": [
        "Tablet"
      ],
      "strength_number": "100",
      "strength_unit": "mg",
      "dosage_form": [
        "Tablet"
      ],
      "route": "",
      "approved": true,
      "unapproved": false,
      "generic": false,
      "otc": false,
      "mixture": false,
      "allergen": false,
      "vaccine": false,
      "ingredients": [
        {
          "drugbank_id": "DB01166",
          "name": "Cilostazol",
          "cas": "73963-72-1",
          "strength_number": "100",
          "strength_unit": "mg"
        }
      ]
    },
    {
      "hits": [
        {
          "field": "name",
          "value": "Sildenafil 50 mg Oral Tablet [<em>Viagra</em>]"
        }
      ],
      "name": "Sildenafil 50 mg Oral Tablet [Viagra]",
      "country": "EU",
      "brands": [
        "Viagra"
      ],
      "ndc_product_codes": null,
      "dpd_codes": null,
      "ema_product_codes": [
        "EMEA/H/C/000202"
      ],
      "ema_ma_numbers": [
        "EMEA/H/C/000202"
      ],
      "pzns": [],
      "co_product_ids": [],
      "tr_product_ids": [],
      "it_product_ids": [],
      "my_product_ids": [],
      "at_product_ids": [],
      "idn_product_ids": [],
      "th_product_ids": [],
      "sg_product_ids": [],
      "dosage_forms": [
        "Tablet, film coated"
      ],
      "strength_number": "50",
      "strength_unit": "mg",
      "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": "50",
          "strength_unit": "mg"
        }
      ]
    },
    "..."
  ]
}

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.drugbank.com/v1/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.

Ingredient Name Search

curl -L 'https://api.drugbank.com/v1/ingredient_names?q=acetaminophen' 
-H 'Authorization: myapikey'

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

[
  {
    "hits": [
      {
        "field": "name.autocomplete",
        "value": "<em>Acetaminophen</em>"
      },
      {
        "field": "synonyms",
        "value": "<em>Acetaminophen</em>"
      }
    ],
    "drugbank_id": "DB00316",
    "name": "Acetaminophen",
    "cas_number": "103-90-2"
  }
]

This endpoint searches and returns drug ingredients only. The results of this search will not contain drug product information, such as brand names or dosage strength/form (see Drug Name Search or Prescribable Name Search). This type of search is useful for looking up information for compounding drugs, drug products outside of our covered regions, or to quickly find the DrugBank ID and simple descriptions for a drug ingredient.

HTTP Request

GET https://api.drugbank.com/v1/ingredient_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_simple_desc	false	If set to true, include simple descriptions for the ingredients.
include_clinical_desc	false	If set to true, include clinical descriptions for the 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 encompass the drug ingredient in question, any salts thereof, and any synonyms captured within DrugBank.

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.drugbank.com/v1/drug_names?q=addvil&fuzzy=true' 
-H 'Authorization: myapikey'

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 (0, 1, or 2) in to tailor the likelihood of a match (for example, fuzzy=1 will allow 1 misspelled letter).

Products

Common Parameters

The following parameters can be applied when retrieving any product.

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. Note that if used, the include_simple_desc and include_clinical_desc parameters will be ignored since the descriptions are already included in the drug details.
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.
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.

Related Products

Related products can be retrieved by appending an endpoint to the url in the following format:

https://api.drugbank.com/v1/products/<ID>/related/<type>

For example:

https://api.drugbank.com/v1/products/<ID>/related/generics

Type	Description
generics	Returns a list of generic i.e. unbranded versions of the product.

Regional Products

Products are identified in different ways in different regions. Here is the list of unique identifier fields for all the currently supported regions.

Region	Region Code	Product ID Field	Local Product ID	Example
Austria	at	at_product_id	MA number	16965
Canada	ca	dpd	DIN	2341093
Colombia	co	co_product_id	Invima ID	INVIMA M-012422
European Union	eu	ema_ma_number	EU MA number	EU/1/04/276/001
European Union	eu	ema_product_code	Product number	EMEA/H/C/000471
Indonesia	idn	idn_product_id	Nomor registrasi	GKL0122234837A1
Italy	it	it_product_id	AIC	038835056
Malaysia	my	my_product_id	Registration no.	MAL12115054ACZ
Singapore	sg	sg_product_id	Licence no.	SIN11734P
Thailand	th	th_product_id	Registration no.	1C 95/60(N)
Turkey	tr	tr_product_id	Barcode	8699508150243
United States	us	ndc	9-digit NDC	0169-5174

Get a specific regional product

Get a specific US product

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

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

{
  "ndc_product_code": "55154-2727",
  "originator_ndc_product_code": "55154-2727",
  "dpd_id": null,
  "ema_product_code": null,
  "ema_ma_number": null,
  "pzn": null,
  "co_product_id": null,
  "tr_product_id": null,
  "it_product_id": null,
  "my_product_id": null,
  "at_product_id": null,
  "idn_product_id": null,
  "th_product_id": null,
  "sg_product_id": null,
  "name": "Viagra",
  "prescribable_name": "Sildenafil citrate 25 mg Oral Tablet [Viagra]",
  "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,
  "allergenic": false,
  "cosmetic": false,
  "vaccine": false,
  "ingredients": [
    {
      "drug": {
        "drugbank_id": "DB00203",
        "name": "Sildenafil",
        "cas_number": "139755-83-2",
        "annotation_status": "complete",
        "availability_by_region": [
          {
            "region": "at",
            "max_phase": 0,
            "marketed_prescription": true,
            "generic_available": false,
            "pre_market_cancelled": false,
            "post_market_cancelled": false
          },
          {
            "region": "ca",
            "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_description": "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": [
          "Take with or without food. If taken with a high-fat meal the medicine may take a little longer to start working."
        ],
        "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",
          "atc_codes": [
            {
              "code": "G01AE10",
              "title": "combinations of sulfonamides",
              "combination": true
            },
            {
              "code": "G04BE03",
              "title": "sildenafil",
              "combination": false
            }
          ]
        },
        "therapeutic_categories": [
          {
            "drugbank_id": "DBCAT000003",
            "name": "Enzyme Inhibitors",
            "mesh_id": "D004791",
            "mesh_tree_numbers": [
              "D27.505.519.389"
            ],
            "atc_code": null,
            "atc_level": null,
            "synonyms": [
              "Inhibitors, Enzyme"
            ],
            "description": "Compounds or agents that combine with an enzyme in such a manner as to prevent the normal substrate-enzyme combination and the catalytic reaction."
          },
          {
            "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."
          },
          "..."
        ]
      },
      "strength": {
        "number": "25",
        "unit": "mg/1"
      }
    }
  ],
  "therapeutic_categories": [
    {
      "drugbank_id": "DBCAT000003",
      "name": "Enzyme Inhibitors",
      "mesh_id": "D004791",
      "mesh_tree_numbers": [
        "D27.505.519.389"
      ],
      "atc_code": null,
      "atc_level": null,
      "synonyms": [
        "Inhibitors, Enzyme"
      ],
      "description": "Compounds or agents that combine with an enzyme in such a manner as to prevent the normal substrate-enzyme combination and the catalytic reaction."
    },
    {
      "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."
    },
    "..."
  ],
  "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 LOCAL PRODUCT ID corresponding to your region.

HTTP Request

Get https://api.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID.

Query Parameters

See Common Parameters.

Get a specific regional product for multi-region subscribers

Get a specific US product

curl -L 'https://api.drugbank.com/v1/products/55154-2727?region=us' 
-H 'Authorization: myapikey'

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

{
  "ndc_product_code": "55154-2727",
  "originator_ndc_product_code": "55154-2727",
  "dpd_id": null,
  "ema_product_code": null,
  "ema_ma_number": null,
  "name": "Viagra",
  "prescribable_name": "Sildenafil citrate 25 mg Oral Tablet [Viagra]",
  "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,
  "allergenic": false,
  "cosmetic": false,
  "vaccine": false,
  "ingredients": [
    {
      "name": "Sildenafil",
      "drugbank_id": "DB00203",
      "strength": {
        "number": "25",
        "unit": "mg/1"
      }
    }
  ],
  "therapeutic_categories": [
    {
      "drugbank_id": "DBCAT000003",
      "name": "Enzyme Inhibitors",
      "mesh_id": "D004791",
      "mesh_tree_numbers": [
        "D27.505.519.389"
      ],
      "atc_code": null,
      "atc_level": null,
      "synonyms": [
        "Inhibitors, Enzyme"
      ],
      "description": "Compounds or agents that combine with an enzyme in such a manner as to prevent the normal substrate-enzyme combination and the catalytic reaction."
    },
    {
      "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."
    },
    "..."
  ],
  "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"
    }
  ]
}

HTTP Request

Get https://api.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>?region=<REGION_CODE>

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID.

Query Parameters

Parameter	Default	Description
region	all subscribed regions	MUST be set to the region that corresponds to the Local Product ID

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

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

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

[
  {
    "ndc_product_code": null,
    "originator_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": "2016-09-08",
    "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,
    "allergenic": false,
    "cosmetic": false,
    "vaccine": false,
    "ingredients": [
      {
        "name": "Olanzapine",
        "drugbank_id": "DB00334",
        "strength": {
          "number": "5",
          "unit": "mg"
        }
      }
    ],
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000696",
        "name": "Adrenergic alpha-Antagonists",
        "mesh_id": "D000317",
        "mesh_tree_numbers": [
          "D27.505.519.625.050.200.100",
          "D27.505.696.577.050.200.100"
        ],
        "atc_code": "G04CA",
        "atc_level": 4,
        "synonyms": [
          "Adrenergic alpha Antagonists",
          "Adrenergic alpha Blockers",
          "..."
        ],
        "description": "Drugs that bind to but do not activate alpha-adrenergic receptors thereby blocking the actions of endogenous or exogenous adrenergic agonists..."
      },
      {
        "drugbank_id": "DBCAT000457",
        "name": "Adrenergic Antagonists",
        "mesh_id": "D018674",
        "mesh_tree_numbers": [
          "D27.505.519.625.050.200",
          "D27.505.696.577.050.200"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Adrenergic Antagonist",
          "Adrenergic Blockaders",
          "..."
        ],
        "description": "Drugs that bind to but do not activate ADRENERGIC RECEPTORS..."
      },
      "..."
    ],
    "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.drugbank.com/v1/eu/products/<EMA_ID>

URL Parameters

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

Query Parameters

See Common Parameters.

Get categories for a product

curl -L 'https://api.drugbank.com/v1/products/55154-2727/categories' 
-H 'Authorization: myapikey'

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 the Local Product ID of your region. See Regional Products.

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.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>/categories/<hierarchy (optional)>

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID of the product to retrieve the categories.

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	The Local Product ID 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.drugbank.com/v1/products/55154-2727/product_concepts' 
-H 'Authorization: myapikey'

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,
      "germany": true,
      "colombia": true,
      "turkey": true,
      "italy": true,
      "malaysia": true,
      "austria": true,
      "indonesia": true,
      "thailand": true,
      "singapore": 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 the Local Product ID of your region. See Regional Products. This endpoint supports pagination.

HTTP Request

GET https://api.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>/product_concepts

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID 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.drugbank.com/v1/products/55154-2727/indications' 
-H 'Authorization: myapikey'

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

[
  {
    "kind": "management_of",
    "off_label": false,
    "otc_use": false,
    "adjunct_use": false,
    "drug": {
      "name": "Sildenafil",
      "drugbank_id": "DB00203"
    },
    "regions": "US",
    "condition": {
      "name": "Erectile Dysfunction",
      "drugbank_id": "DBCOND0029956",
      "meddra_id": "llt/10025503",
      "snomed_id": "c/268762007",
      "icd10_id": "c/F52.21"
    }
  }
]

This endpoint retrieves a list of indications linked to a product, based on the Local Product ID of your region. See Regional Products. This endpoint supports pagination.

HTTP Request

GET https://api.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>/indications

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID 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.
adjunct_use	null	Limits results by the value of the adjunct_use attribute of the indications.
kind	null	Limits results by the value of the kind attribute of the indications.

Get product concepts with similar indications

curl -L 'https://api.drugbank.com/v1/products/55154-2727/product_concepts/similar_indications' 
-H 'Authorization: myapikey'

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

{
  "similar_indications": [
    {
      "product_concept": {
        "name": "Treprostinil Intravenous; Subcutaneous",
        "display_name": null,
        "drugbank_pcid": "DBPC0107254",
        "brand": null,
        "level": 2,
        "route": "Intravenous; Subcutaneous",
        "form": null,
        "strengths": null,
        "standing": "active",
        "standing_updated_at": "2018-09-12",
        "standing_active_since": "2002-05-22",
        "regions": {
          "us": true,
          "canada": true,
          "eu": false,
          "germany": false,
          "colombia": true,
          "turkey": false,
          "italy": false,
          "malaysia": false,
          "austria": false,
          "indonesia": false,
          "thailand": false,
          "singapore": false
        },
        "rxnorm_concepts": [
          {
            "name": "treprostinil Injectable Product",
            "RXCUI": "1157682"
          }
        ],
        "ingredients": [
          {
            "name": "Treprostinil",
            "drug": {
              "name": "Treprostinil",
              "drugbank_id": "DB00374"
            }
          }
        ]
      },
      "from": {
        "concept": {
          "title": "Pulmonary Arterial Hypertension (PAH)",
          "drugbank_id": "DBCOND0039281"
        },
        "indication": {
          "kind": "treatment_of",
          "off_label": false,
          "otc_use": false,
          "route": [
            "Intravenous",
            "Oral"
          ],
          "dose_form": [
            "Injection",
            "Suspension",
            "..."
          ],
          "dose_strength": [],
          "drug": {
            "name": "Sildenafil",
            "drugbank_id": "DB00203"
          },
          "regions": "US",
          "condition": {
            "name": "Pulmonary Arterial Hypertension (PAH)",
            "drugbank_id": "DBCOND0039281",
            "meddra_id": "llt/10064911",
            "snomed_id": "c/11399002",
            "icd10_id": "c/I27.21",
            "uniprot_id": "ac/P00439"
          }
        }
      },
      "to": {
        "concept": {
          "title": "Pulmonary Arterial Hypertension (PAH)",
          "drugbank_id": "DBCOND0039281"
        },
        "indication": {
          "kind": "treatment_of",
          "off_label": false,
          "otc_use": false,
          "route": [
            "Intravenous",
            "Subcutaneous"
          ],
          "dose_form": [
            "Solution"
          ],
          "dose_strength": [],
          "drug": {
            "name": "Treprostinil",
            "drugbank_id": "DB00374"
          },
          "regions": "Canada",
          "condition": {
            "name": "Pulmonary Arterial Hypertension (PAH)",
            "drugbank_id": "DBCOND0039281",
            "meddra_id": "llt/10064911",
            "snomed_id": "c/11399002",
            "icd10_id": "c/I27.21",
            "uniprot_id": "ac/P00439"
          },
          "condition_associated_with": [
            {
              "name": "NYHA class IV",
              "drugbank_id": "DBCOND0025254"
            },
            {
              "name": "Refractory to conventional therapy",
              "drugbank_id": "DBCOND0024014"
            }
          ]
        }
      }
    },
    {
      "product_concept": {
        "name": "Treprostinil Subcutaneous",
        "drugbank_pcid": "DBPC0688857",
        "level": 2,
        "route": "Subcutaneous",
        "standing": "active",
        "regions": {
          "us": false,
          "canada": false,
          "eu": true,
          "germany": false,
          "colombia": false,
          "turkey": false,
          "italy": true,
          "malaysia": false,
          "austria": false,
          "indonesia": false,
          "thailand": false,
          "singapore": false
        },
        "rxnorm_concepts": [],
        "ingredients": [
          {
            "name": "Treprostinil",
            "drug": {
              "name": "Treprostinil",
              "drugbank_id": "DB00374"
            }
          }
        ]
      },
      "from": {
        "concept": {
          "title": "Pulmonary Arterial Hypertension (PAH)",
          "drugbank_id": "DBCOND0039281"
        },
        "indication": {
          "kind": "treatment_of",
          "off_label": false,
          "otc_use": false,
          "route": [
            "Intravenous",
            "Oral"
          ],
          "dose_form": [
            "Injection",
            "Suspension",
            "..."
          ],
          "dose_strength": [],
          "drug": {
            "name": "Sildenafil",
            "drugbank_id": "DB00203"
          },
          "regions": "US",
          "condition": {
            "name": "Pulmonary Arterial Hypertension (PAH)",
            "drugbank_id": "DBCOND0039281",
            "meddra_id": "llt/10064911",
            "snomed_id": "c/11399002",
            "icd10_id": "c/I27.21",
            "uniprot_id": "ac/P00439"
          }
        }
      },
      "to": {
        "concept": {
          "title": "Pulmonary Arterial Hypertension (PAH)",
          "drugbank_id": "DBCOND0039281"
        },
        "indication": {
          "kind": "treatment_of",
          "off_label": false,
          "otc_use": false,
          "route": [
            "Intravenous",
            "Subcutaneous"
          ],
          "dose_form": [
            "Solution"
          ],
          "dose_strength": [],
          "drug": {
            "name": "Treprostinil",
            "drugbank_id": "DB00374"
          },
          "regions": "Canada",
          "condition": {
            "name": "Pulmonary Arterial Hypertension (PAH)",
            "drugbank_id": "DBCOND0039281",
            "meddra_id": "llt/10064911",
            "snomed_id": "c/11399002",
            "icd10_id": "c/I27.21",
            "uniprot_id": "ac/P00439"
          },
          "condition_associated_with": [
            {
              "name": "NYHA class IV",
              "drugbank_id": "DBCOND0025254"
            },
            {
              "name": "Refractory to conventional therapy",
              "drugbank_id": "DBCOND0024014"
            }
          ]
        }
      }
    },
    "..."
  ]
}

This endpoint retrieves a list of product concepts which have indications similar to the indications of the provided product.

The results are returned as a JSON object with a “similar_indications” property containing an array of objects representing similar product concepts. Each object in this array has three properties: product_concept (the similar product_concept), from, and to.

From and to describe the relationship between the input product concept and the similar product concept. From and to both contain the same two properties:

• concept, a condition object, and
• indication, an indication object.

HTTP Request

GET https://api.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>/product_concepts/similar_indications

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID of the product to retrieve the linked product concepts with similar indications.

Get drug-drug interactions for a product

curl -L 'https://api.drugbank.com/v1/products/55154-2727/ddi?severity=moderate&available_only=true' 
-H 'Authorization: myapikey'

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

[
  {
    "product_ingredient": {
      "drugbank_id": "DB00203",
      "name": "Sildenafil"
    },
    "affected_product_ingredient": {
      "drugbank_id": "DB01281",
      "name": "Abatacept"
    },
    "description": "The metabolism of Sildenafil can be increased when combined with Abatacept.",
    "extended_description": "The formation of CYP450 enzymes is inhibited by the presence of increased levels of cytokines during chronic inflammation...",
    "action": "increase_dynamics",
    "severity": "moderate",
    "subject_dosage": "",
    "affected_dosage": "",
    "evidence_level": "level_1",
    "management": "When treatment with agents that reduce cytokine levels is initiated or discontinued, monitor for reduced efficacy of drugs that are CYP2C9 substrates a..."
  }
]

This endpoint retrieves a list of drug-drug interactions linked to a product, based on the Local Product ID of your region. See Regional Products. 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.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>/ddi

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID 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.
evidence_level	null	Limits results by the evidence level of the interactions. May be level_1 or level_2.
available_only	false	If true, only includes interactions with currently available drugs. If a region is specified, the drugs must also be available in that region.
include_references	false	If true, includes the references for each interaction. See References for details on the format.

Get adverse effects linked with a product

curl -L 'https://api.drugbank.com/v1/products/55154-2727/adverse_effects' 
-H 'Authorization: myapikey'

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

[
  {
    "drug": {
      "name": "Sildenafil",
      "drugbank_id": "DB00203"
    },
    "route": [
      "Intravenous",
      "Oral"
    ],
    "dose_form": [
      "Injection",
      "Powder, for suspension",
      "..."
    ],
    "dose_strength": [
      "20-80 mg"
    ],
    "evidence_type": [
      "clinical_trial"
    ],
    "admin": "Three times daily",
    "trial_name": [],
    "regions": "US",
    "age_groups": [
      "adult"
    ],
    "incidences": [
      {
        "kind": "experimental",
        "percent": "57"
      },
      {
        "kind": "comparator",
        "name": "Epoprostenol",
        "percent": "34"
      }
    ],
    "effect": {
      "name": "Headache",
      "drugbank_id": "DBCOND0017979",
      "meddra_id": "hlgt/10019231",
      "snomed_id": "c/271329006",
      "icd10_id": "c/R51"
    },
    "patient_characteristics": [
      {
        "name": "Pulmonary Arterial Hypertension (PAH) (WHO Group 1 PH)",
        "drugbank_id": "DBCOND0118779",
        "icd10_id": "c/I27.21",
        "combination_of": {
          "additional_characteristics": [
            "WHO Group 1"
          ],
          "included_conditions": [
            {
              "name": "Pulmonary Arterial Hypertension",
              "drugbank_id": "DBCOND0030321",
              "meddra_id": "llt/10064911",
              "snomed_id": "c/11399002",
              "icd10_id": "c/I27.21",
              "uniprot_id": "ac/P00439"
            }
          ]
        }
      }
    ],
    "with_drugs": [
      {
        "name": "Epoprostenol",
        "drugbank_id": "DB01240"
      }
    ]
  }
]

This endpoint retrieves a list of adverse effects linked to a product, based on the Local Product ID of your region. See Regional Products. This endpoint supports pagination.

HTTP Request

GET https://api.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>/adverse_effects

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID of the product to retrieve the linked adverse effects.

Query Parameters

Parameter	Default	Description
include_references	false	If true, includes the list of references for each adverse effect associated with this product. See References for details.

Get contraindications linked with a product

curl -L 'https://api.drugbank.com/v1/products/16590-0022/contraindications' 
-H 'Authorization: myapikey'

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

[
  {
    "drug": {
      "name": "Acetaminophen",
      "drugbank_id": "DB00316"
    },
    "route": [],
    "dose_form": [],
    "hypersensitivity": [
      "true"
    ],
    "lab_values": [],
    "recommended_actions": [],
    "regions": "US"
  }
]

This endpoint retrieves a list of contraindications linked to a product, based on the Local Product ID of your region. See Regional Products. This endpoint supports pagination.

HTTP Request

GET https://api.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>/contraindications

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID of the product to retrieve the linked contraindications.

Get boxed warnings linked with a product

curl -L 'https://api.drugbank.com/v1/products/16590-0022/boxed_warnings' 
-H 'Authorization: myapikey'

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

[
  {
    "drug": {
      "name": "Acetaminophen",
      "drugbank_id": "DB00316"
    },
    "kind": "warning",
    "recommendation": "Do not exceed recommended daily maximum limits",
    "lab_values": [],
    "route": [],
    "dose_form": [],
    "risk": {
      "name": "Liver Failure",
      "drugbank_id": "DBCOND0031848",
      "meddra_id": "pt/10019663",
      "snomed_id": "c/235883002",
      "icd10_id": "c/K72.9"
    }
  }
]

This endpoint retrieves a list of boxed warnings (Black Box warnings) linked to a product, based on the Local Product ID of your region. See Regional Products. This endpoint supports pagination.

HTTP Request

GET https://api.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>/boxed_warnings

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID of the product to retrieve the linked boxed_warnings.

Get packages for a product

curl -L 'https://api.drugbank.com/v1/products/63304-803/packages' 
-H 'Authorization: myapikey'

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

[
  {
    "package_ndc_code": "63304-0803-30",
    "originator_package_ndc_code": "63304-803-30",
    "description": "30 TABLET IN 1 BOTTLE",
    "full_description": "30 TABLET IN 1 BOTTLE",
    "amount": "30",
    "unit": "1",
    "form": "BOTTLE"
  },
  {
    "package_ndc_code": "63304-0803-05",
    "originator_package_ndc_code": "63304-803-05",
    "description": "500 TABLET IN 1 BOTTLE",
    "full_description": "500 TABLET IN 1 BOTTLE",
    "amount": "500",
    "unit": "1",
    "form": "BOTTLE"
  }
]

This endpoint retrieves a list of top level packages for a product, based on the Local Product ID of your region. This endpoint supports pagination.

HTTP Request

GET https://api.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>/packages

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID of the product to retrieve the packages.

Get allergy details linked with a product

curl -L 'https://api.drugbank.com/v1/products/57841-1150/allergy_details' 
-H 'Authorization: myapikey'

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

[
  {
    "ingredient": {
      "drugbank_id": "DB00615",
      "name": "Rifabutin"
    },
    "details": [
      {
        "summary": "Hypersensitivity to Rifamycins can present as: Cutaneous Manifestations of Drug Allergy, drug-induced lupus erythematosus, Allergic Glomerulonephritis,...",
        "info": "Rifamycins are members of the ansamycin antibiotic family with an ansa poly-hydroxylated bridge connecting both ends of a naphthoquinone core, and are ...",
        "evidence_type": [
          "clinical_trial",
          "post_marketing",
          "..."
        ],
        "hypersensitivity_types": [
          "Type I",
          "Type II",
          "..."
        ],
        "presentations": [
          "Acute Generalized Exanthematous Pustulosis",
          "Acute Interstitial Nephritis",
          "..."
        ]
      }
    ]
  }
]

This endpoint retrieves allergy information linked to ingredients in a product.

Ingredients with no associated allergy details will not show up. Allergy details for each ingredient will show up as a list.

HTTP Request

GET https://api.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>/allergy_details

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID of the product to retrieve the allergy details.

Query Parameters

Parameter	Default	Description
include_presentation_details	false	If set to true, include details of each presentation.
include_source_details	false	If set to true, include source_name and source_type for this allergy detail (useful when there are multiple allergy details).
include_references	false	If true, includes the lists of references for allergy information. See References for details.

Get cross-sensitivities linked with a product

curl -L 'https://api.drugbank.com/v1/products/57841-1150/cross_sensitivities' 
-H 'Authorization: myapikey'

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

[
  {
    "ingredient": {
      "name": "Rifabutin",
      "drugbank_id": "DB00615"
    },
    "summary": "As a Rifamycin, Rifabutin is known to be cross-sensitive with Rifamycins",
    "description": "One _in vitro_ study was performed to determine cross-sensitivity in a patient who was hypersensitive to rifamycin SV and rifaximin...",
    "incidence": "Rare",
    "evidence_type": [
      "case_reports"
    ],
    "cross_sensitive_drugs": [
      {
        "name": "Rifampicin",
        "drugbank_id": "DB01045"
      },
      {
        "name": "Rifamycin",
        "drugbank_id": "DB11753"
      },
      "..."
    ]
  }
]

This endpoint retrieves cross-sensitivity information linked to ingredients in a product.

Ingredients with no associated cross-sensitivities will not show up. Cross-sensitivities for each ingredient will show up as a list.

HTTP Request

GET https://api.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>/cross_sensitivities

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID of the product to retrieve the cross-sensitivities.

Query Parameters

Parameter	Default	Description
include_references	false	If true, includes the lists of references for cross-sensitivity information. See References for details.

Get the most current FDA label for a product

curl -L 'https://api.drugbank.com/v1/products/50580-111/label' 
-H 'Authorization: myapikey'

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

{
  "id": "5a42290a-810c-427c-a406-2df70a02c372",
  "set_id": "81f3847f-99e8-4ff3-ad18-f8b8e1c54238",
  "version": 1,
  "current": true,
  "title": "Tylenol Extra Strength - Acetaminophen LIQUID",
  "product_type": "HUMAN OTC DRUG LABEL",
  "effective_on": "2012-12-10",
  "labeler_name": "McNeil Consumer Healthcare Div. McNeil-PPC, Inc",
  "drugbank_status": "processed",
  "first_product_marketing_started_on": "1998-04-01",
  "last_product_marketing_ended_on": "2012-10-31",
  "pmg_section_count": 6,
  "hpi_section_count": 9,
  "sli_section_count": 2,
  "all_section_count": 17,
  "abuse": null,
  "accessories": null,
  "active_ingredient": "<section id=\"section-2\" class=\"content-section\" data-section-code=\"55106-9\"><h1>Active ingredient (in each 15 mL = 1 tablespoon)</h1>\n<div class=\"conte...",
  "adverse_reactions": null,
  "alarms": null,
  "animal_pharmacology_and_or_toxicology": null,
  "ask_doctor": "<section id=\"section-5...",
  "ask_doctor_or_pharmacist": "<section id=\"section-5...",
  "assembly_or_installation_instructions": null,
  "boxed_warning": null,
  "calibration_instructions": null,
  "carcinogenesis_and_mutagenesis_and_impairment_of_fertility": null,
  "cleaning": null,
  "clinical_pharmacology": null,
  "clinical_studies": null,
  "compatible_accessories": null,
  "components": null,
  "contraindications": null,
  "controlled_substance": null,
  "dependence": null,
  "description": null,
  "diagram_of_device": null,
  "disposal_and_waste_handling": null,
  "do_not_use": "<section id=\"section-5...",
  "dosage_and_administration": "<section id=\"section-6\" class=\"content-section\" data-section-code=\"34068-7\"><h1>Directions</h1>\n<div class=\"content-section-inner\" id=\"\">\n<ul class=\"sq...",
  "dosage_forms_and_strengths": null,
  "drug_abuse_and_dependence": null,
  "drug_interactions": null,
  "drug_and_or_laboratory_test_interactions": null,
  "environmental_warning": null,
  "food_safety_warning": null,
  "general_precautions": null,
  "geriatric_use": null,
  "guaranteed_analysis_of_feed": null,
  "health_care_provider_letter": null,
  "health_claim": null,
  "how_supplied": null,
  "inactive_ingredient": "<section id=\"section-8\" class=\"content-section\" data-section-code=\"51727-6\"><h1>Inactive ingredients</h1>\n<div class=\"content-section-inner\" id=\"\"><p>a...",
  "indications_and_usage": "<section id=\"section-4\" class=\"content-section\" data-section-code=\"34067-9\"><h1>Uses</h1>\n<div class=\"content-section-inner\" id=\"\"><ul class=\"square\">\n...",
  "information_for_owners_or_caregivers": null,
  "information_for_patients": null,
  "instructions_for_use": null,
  "intended_use_of_the_device": null,
  "keep_out_of_reach_of_children": "<section id=\"section-5...",
  "labor_and_delivery": null,
  "laboratory_tests": null,
  "mechanism_of_action": null,
  "microbiology": null,
  "nonclinical_toxicology": null,
  "nonteratogenic_effects": null,
  "nursing_mothers": null,
  "other_safety_information": null,
  "overdosage": null,
  "package_label_principal_display_panel": "<section id=\"section-10\" class=\"content-section\" data-section-code=\"51945-4\"><h1>PRINCIPAL DISPLAY PANEL</h1>\n<div class=\"content-section-inner\" id=\"\">...",
  "patient_medication_information": null,
  "pediatric_use": null,
  "pharmacodynamics": null,
  "pharmacogenomics": null,
  "pharmacokinetics": null,
  "precautions": null,
  "pregnancy": null,
  "pregnancy_or_breast_feeding": "<section id=\"section-5...",
  "purpose": "<section id=\"section-3\" class=\"content-section\" data-section-code=\"55105-1\"><h1>Purpose</h1>\n<div class=\"content-section-inner\" id=\"\"><p>Pain reliever/...",
  "questions": "<section id=\"section-9\" class=\"content-section\" data-section-code=\"53413-1\"><h1>Questions or comments?</h1>\n<div class=\"content-section-inner\" id=\"\"><p...",
  "recent_major_changes": null,
  "references": null,
  "residue_warning": null,
  "risks": null,
  "route": null,
  "safe_handling_warning": null,
  "spl_indexing_data_elements": null,
  "spl_medguide": null,
  "spl_patient_package_insert": null,
  "spl_product_data_elements": null,
  "spl_unclassified": "<section id=\"section-1\" class=\"content-section\" data-section-code=\"42229-5\"><div class=\"content-section-inner\" id=\"\"><p><span class=\"bold italics\">Drug...",
  "statement_of_identity": null,
  "stop_use": "<section id=\"section-5...",
  "storage_and_handling": "<section id=\"section-7\" class=\"content-section\" data-section-code=\"44425-7\"><h1>Other information</h1>\n<div class=\"content-section-inner\" id=\"\"><ul cla...",
  "summary_of_safety_and_effectiveness": null,
  "teratogenic_effects": null,
  "troubleshooting": null,
  "use_in_specific_populations": null,
  "user_safety_warnings": null,
  "warnings": "<section id=\"section-5\" class=\"content-section\" data-section-code=\"34071-1\"><h1>Warnings</h1>\n<div class=\"content-section-inner\" id=\"\">\n<section id=\"se...",
  "warnings_and_cautions": null,
  "when_using": null
}

This endpoint retrieves the most current FDA label for a drug product, based on NDC ID.

HTTP Request

GET https://api.drugbank.com/v1/products/<NDC_ID>/label

Query Parameters

Parameter	Default	Description
content_format	html	Format to return for section content from label, either html (default) or text.

View Drug Alternatives for a Product

curl -L 'https://api.drugbank.com/v1/products/57841-1150/product_concepts/therapeutic_alternatives' 
-H 'Authorization: myapikey'

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

[
  {
    "drugbank_id": "DB00615",
    "name": "Rifabutin",
    "categories": [
      {
        "drugbank_id": "DBCAT003667",
        "name": "Drugs for Treatment of Tuberculosis",
        "mesh_id": "D000995",
        "mesh_tree_numbers": [
          "D27.505.954.122.085.255"
        ],
        "atc_code": "J04A",
        "atc_level": 3,
        "categorization_kinds": [
          "therapeutic",
          "indexing"
        ],
        "synonyms": [
          "Agents, Antitubercular",
          "Agents, Tuberculostatic",
          "..."
        ],
        "description": "Drugs used in the treatment of tuberculosis...",
        "drugs": [
          {
            "drugbank_id": "DB00330",
            "name": "Ethambutol"
          },
          {
            "drugbank_id": "DB00339",
            "name": "Pyrazinamide"
          },
          "..."
        ]
      },
      {
        "drugbank_id": "DBCAT003383",
        "name": "Rifamycin Antimycobacterial",
        "mesh_id": null,
        "mesh_tree_numbers": [],
        "atc_code": null,
        "atc_level": null,
        "categorization_kinds": [
          "therapeutic"
        ],
        "synonyms": [],
        "description": null,
        "drugs": [
          {
            "drugbank_id": "DB01201",
            "name": "Rifapentine"
          }
        ]
      }
    ]
  }
]

This endpoint retrieves lists of drugs as therapeutic alternatives based on the therapeutic categorizations of the ingredients associated with the provided product.

Related products to the drug alternatives can then be found using this endpoint.

HTTP Request

GET https://api.drugbank.com/v1/products/<LOCAL_PRODUCT_ID>/product_concepts/therapeutic_ alternatives

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	Percent encoded Local Product ID of the product to retrieve the linked therapeutic alternatives.

Product Concepts

About Product Concepts

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.

• API returns status code 404 if the product concept does not exist
• API returns status code 410 if the product concept has been revoked

Data Types

The product concepts API uses the following data types:

• structured indications
• product concepts

Product Concepts

{
  "name": "Lopinavir 100 mg / Ritonavir 25 mg Oral Tablet, film coated [Kaletra]",
  "display_name": "Kaletra 100 mg, 25 mg Oral Tablet, film coated",
  "drugbank_pcid": "DBPC0198939",
  "brand": "Kaletra",
  "level": 5,
  "route": "Oral",
  "form": "Tablet, film coated",
  "strengths": "100 mg, 25 mg",
  "standing": "active",
  "standing_updated_at": "2018-09-12",
  "standing_active_since": "2006-12-21",
  "regions": {
    "us": true,
    "canada": false,
    "eu": false
  },
  "rxnorm_concepts": [
    {
      "name": "lopinavir 100 MG / Ritonavir 25 MG Oral Tablet [Kaletra]",
      "RXCUI": "847745"
    }
  ],
  "ingredients": [
    {
      "name": "Lopinavir",
      "drug": {
        "name": "Lopinavir",
        "drugbank_id": "DB01601"
      },
      "strength": {
        "amount": "100.0",
        "per": "1.0",
        "units": "mg"
      }
    },
    {
      "name": "Ritonavir",
      "drug": {
        "name": "Ritonavir",
        "drugbank_id": "DB00503"
      },
      "strength": {
        "amount": "25.0",
        "per": "1.0",
        "units": "mg"
      }
    }
  ]
}

Property	Type	Description
drugbank_pcid	string	DrugBank id for the product concept.
name	string	The name of this product concept. Name describes all key characteristics.
display_name	string	An optional, more compact name, based on the brand name.
level	int	Level of the product concept in the hierarchy. 0 = root.
standing	string	Indicates the level of connection this product concept has to products.
standing_updated_at	date	Indicates the date of the last update to the standing of the product concept
standing_active_since	date	Indicates the date that the standing became “active”
regions	object	Indicates the availability of this product concept the regions “us”, “canada”, and “eu”
brand	string
form	string
route	string
strengths	string	A string representing the strengths of the ingredients
rxnorm_concepts	array of objects	An array of objects with name and RXCUI properties, indicating equivalent RxNorm concepts.
ingredients	array of objects	The ingredients in the product concept.

Standings

The standing property can have the following values:

• active
• inactive
• archived

Product Concept Ingredients

{
    "name": "Lopinavir",
    "drug": {
        "name": "Lopinavir",
        "drugbank_id": "DB01601"
    },
    "strength": {
        "amount": "100.0",
        "per": "1.0",
        "units": "mg"
    }
}

Property	Type	Description
drug	object	The drug being represented as an ingredient. Includes name and drugbank_id properties.
salt	object	The salt being represented as an ingredient. Includes name and drugbank_id properties.
amount	string
per	string
units	string

Product Concepts Search

Searching for a specific product concept can be achieved using our medication name search endpoint.

View Product Concept

curl -L 'https://api.drugbank.com/v1/product_concepts/DBPC0001930' 
-H 'Authorization: myapikey'

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": "1999-10-07",
  "regions": {
    "us": true,
    "canada": true,
    "eu": false,
    "germany": false,
    "colombia": true,
    "turkey": true,
    "italy": false,
    "malaysia": true,
    "austria": true,
    "indonesia": true,
    "thailand": true,
    "singapore": true
  },
  "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.drugbank.com/v1/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.drugbank.com/v1/product_concepts/DBPC0001930/products' 
-H 'Authorization: myapikey'

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

[
  {
    "ndc_product_code": "71335-0291",
    "originator_ndc_product_code": "71335-0291",
    "dpd_id": null,
    "ema_product_code": null,
    "ema_ma_number": null,
    "pzn": null,
    "co_product_id": null,
    "tr_product_id": null,
    "it_product_id": null,
    "my_product_id": null,
    "at_product_id": null,
    "idn_product_id": null,
    "th_product_id": null,
    "sg_product_id": 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": "2016-06-20",
    "ended_marketing_on": null,
    "approved_on": null,
    "schedule": null,
    "dosage_form": "Tablet, delayed release",
    "route": "Oral",
    "application_number": "ANDA205119",
    "generic": true,
    "otc": false,
    "approved": true,
    "country": "US",
    "mixture": false,
    "allergenic": false,
    "cosmetic": false,
    "vaccine": false,
    "ingredients": [
      {
        "name": "Pantoprazole",
        "drugbank_id": "DB00213",
        "strength": {
          "number": "20",
          "unit": "mg/1"
        }
      }
    ],
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000003",
        "name": "Enzyme Inhibitors",
        "mesh_id": "D004791",
        "mesh_tree_numbers": [
          "D27.505.519.389"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Inhibitors, Enzyme"
        ],
        "description": "Compounds or agents that combine with an enzyme in such a manner as to prevent the normal substrate-enzyme combination and the catalytic reaction."
      },
      {
        "drugbank_id": "DBCAT003882",
        "name": "Gastric Acid Lowering Agents",
        "mesh_id": null,
        "mesh_tree_numbers": [],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Gastric Acid Inhibitors",
          "Treatment of Gastric Acidity"
        ],
        "description": "Drugs used in the treatment of excessive production of gastric acid."
      },
      "..."
    ],
    "labeller": {
      "name": "bryant ranch prepack"
    },
    "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 region parameter.

HTTP Request

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

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 ingredients.
include_clinical_desc	false	If set to true, include clinical descriptions for the product ingredients.

Filters

Products can be narrowed down by appending a filter to the url in the following format:

https://api.drugbank.com/v1/product_concepts/<ID>/products/<filter>

For example:

https://api.drugbank.com/v1/product_concepts/<ID>/products/generics

Filter	Description
generics	Returns only generic i.e. unbranded products.

View Product Concept Routes

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

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

[
  {
    "name": "Pantoprazole sodium 20 mg Oral Tablet, coated",
    "display_name": null,
    "drugbank_pcid": "DBPC0656321",
    "brand": null,
    "level": 5,
    "route": "Oral",
    "form": "Tablet, coated",
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": null,
    "standing_active_since": "1999-10-07",
    "regions": {
      "us": false,
      "canada": false,
      "eu": false,
      "germany": false,
      "colombia": false,
      "turkey": false,
      "italy": false,
      "malaysia": true,
      "austria": false,
      "indonesia": false,
      "thailand": false,
      "singapore": true
    },
    "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",
    "display_name": null,
    "drugbank_pcid": "DBPC0637413",
    "brand": null,
    "level": 5,
    "route": "Oral",
    "form": "Tablet",
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": null,
    "standing_active_since": "2016-07-04",
    "regions": {
      "us": false,
      "canada": false,
      "eu": false,
      "germany": false,
      "colombia": false,
      "turkey": false,
      "italy": false,
      "malaysia": true,
      "austria": false,
      "indonesia": false,
      "thailand": false,
      "singapore": true
    },
    "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 medication name 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.drugbank.com/v1/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.drugbank.com/v1/product_concepts/DBPC0001930/forms' 
-H 'Authorization: myapikey'

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

[
  {
    "name": "Pantoprazole sodium 20 mg Oral Tablet",
    "display_name": null,
    "drugbank_pcid": "DBPC0637413",
    "brand": null,
    "level": 5,
    "route": "Oral",
    "form": "Tablet",
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": null,
    "standing_active_since": "2016-07-04",
    "regions": {
      "us": false,
      "canada": false,
      "eu": false,
      "germany": false,
      "colombia": false,
      "turkey": false,
      "italy": false,
      "malaysia": true,
      "austria": false,
      "indonesia": false,
      "thailand": false,
      "singapore": true
    },
    "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, coated",
    "display_name": null,
    "drugbank_pcid": "DBPC0656321",
    "brand": null,
    "level": 5,
    "route": "Oral",
    "form": "Tablet, coated",
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": null,
    "standing_active_since": "1999-10-07",
    "regions": {
      "us": false,
      "canada": false,
      "eu": false,
      "germany": false,
      "colombia": false,
      "turkey": false,
      "italy": false,
      "malaysia": true,
      "austria": false,
      "indonesia": false,
      "thailand": false,
      "singapore": true
    },
    "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 medication name 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.drugbank.com/v1/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.drugbank.com/v1/product_concepts/DBPC0001930/strengths' 
-H 'Authorization: myapikey'

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

[
  {
    "name": "Pantoprazole sodium 20 mg Oral Tablet, coated",
    "display_name": null,
    "drugbank_pcid": "DBPC0656321",
    "brand": null,
    "level": 5,
    "route": "Oral",
    "form": "Tablet, coated",
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": null,
    "standing_active_since": "1999-10-07",
    "regions": {
      "us": false,
      "canada": false,
      "eu": false,
      "germany": false,
      "colombia": false,
      "turkey": false,
      "italy": false,
      "malaysia": true,
      "austria": false,
      "indonesia": false,
      "thailand": false,
      "singapore": true
    },
    "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",
    "display_name": null,
    "drugbank_pcid": "DBPC0637413",
    "brand": null,
    "level": 5,
    "route": "Oral",
    "form": "Tablet",
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": null,
    "standing_active_since": "2016-07-04",
    "regions": {
      "us": false,
      "canada": false,
      "eu": false,
      "germany": false,
      "colombia": false,
      "turkey": false,
      "italy": false,
      "malaysia": true,
      "austria": false,
      "indonesia": false,
      "thailand": false,
      "singapore": true
    },
    "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 medication name 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.drugbank.com/v1/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.drugbank.com/v1/product_concepts/DBPC0001930/categories' 
-H 'Authorization: myapikey'

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.drugbank.com/v1/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.drugbank.com/v1/product_concepts/DBPC0131467/indications' 
-H 'Authorization: myapikey'

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

[
  {
    "kind": "treatment_of",
    "off_label": false,
    "otc_use": false,
    "adjunct_use": false,
    "route": [
      "Intravenous",
      "Subcutaneous"
    ],
    "dose_form": [
      "Injection"
    ],
    "dose_strength": [],
    "timeline": "When chemotherapy is planned to last ≥2 months",
    "drug": {
      "name": "Darbepoetin alfa",
      "drugbank_id": "DB00012"
    },
    "regions": "US",
    "condition": {
      "name": "Anemia",
      "drugbank_id": "DBCOND0020261",
      "meddra_id": "pt/10002034",
      "snomed_id": "c/191277004",
      "icd10_id": "c/D64.9"
    },
    "condition_associated_with": [
      {
        "name": "Myelosuppressive chemotherapy",
        "drugbank_id": "DBCOND0020351"
      }
    ]
  }
]

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.drugbank.com/v1/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.
adjunct_use	null	Limits results by the value of the adjunct_use attribute of the indications.
kind	null	Limits results by the value of the kind attribute of the indications.

View product concepts with similar indications

curl -L 'https://api.drugbank.com/v1/product_concepts/DBPC0131467/similar_indications' 
-H 'Authorization: myapikey'

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

{
  "similar_indications": [
    {
      "product_concept": {
        "name": "Erythropoietin Subcutaneous Injection, solution",
        "display_name": null,
        "drugbank_pcid": "DBPC0567562",
        "brand": null,
        "level": 3,
        "route": "Subcutaneous",
        "form": "Injection, solution",
        "strengths": null,
        "standing": "active",
        "standing_updated_at": null,
        "standing_active_since": null,
        "regions": {
          "us": false,
          "canada": false,
          "eu": false,
          "germany": false,
          "colombia": false,
          "turkey": false,
          "italy": true,
          "malaysia": false,
          "austria": false,
          "indonesia": false,
          "thailand": false,
          "singapore": false
        },
        "rxnorm_concepts": [],
        "ingredients": [
          {
            "name": "Erythropoietin",
            "drug": {
              "name": "Erythropoietin",
              "drugbank_id": "DB00016"
            }
          }
        ]
      },
      "from": {
        "concept": {
          "title": "Anemia",
          "drugbank_id": "DBCOND0020261"
        },
        "indication": {
          "kind": "treatment_of",
          "off_label": false,
          "otc_use": false,
          "route": [
            "Intravenous",
            "Subcutaneous"
          ],
          "dose_form": [
            "Injection"
          ],
          "dose_strength": [],
          "timeline": "When chemotherapy is planned to last ≥2 months",
          "drug": {
            "name": "Darbepoetin alfa",
            "drugbank_id": "DB00012"
          },
          "regions": "US",
          "condition": {
            "name": "Anemia",
            "drugbank_id": "DBCOND0020261",
            "meddra_id": "pt/10002034",
            "snomed_id": "c/191277004",
            "icd10_id": "c/D64.9"
          },
          "condition_associated_with": [
            {
              "name": "Myelosuppressive chemotherapy",
              "drugbank_id": "DBCOND0020351"
            }
          ]
        }
      },
      "to": {
        "concept": {
          "title": "Anemia",
          "drugbank_id": "DBCOND0020261"
        },
        "indication": {
          "kind": "treatment_of",
          "off_label": false,
          "otc_use": false,
          "route": [
            "Intravenous",
            "Subcutaneous"
          ],
          "dose_form": [
            "Injection"
          ],
          "dose_strength": [],
          "drug": {
            "name": "Erythropoietin",
            "drugbank_id": "DB00016"
          },
          "regions": "US",
          "condition": {
            "name": "Anemia",
            "drugbank_id": "DBCOND0020261",
            "meddra_id": "pt/10002034",
            "snomed_id": "c/191277004",
            "icd10_id": "c/D64.9"
          },
          "condition_associated_with": [
            {
              "name": "Chronic Kidney Disease",
              "drugbank_id": "DBCOND0030403",
              "meddra_id": "llt/10064848",
              "snomed_id": "c/236425005",
              "icd10_id": "c/N18",
              "modification_of": {
                "base": {
                  "name": "Kidney Diseases",
                  "drugbank_id": "DBCOND0028223",
                  "meddra_id": "llt/10051051",
                  "snomed_id": "c/266627003",
                  "icd10_id": "c/N28.9"
                },
                "severity": {
                  "includes": [
                    "chronic"
                  ],
                  "excludes": []
                }
              }
            }
          ]
        }
      }
    },
    {
      "product_concept": {
        "name": "Erythropoietin Intravenous; Parenteral Injection, solution",
        "drugbank_pcid": "DBPC0567532",
        "level": 3,
        "route": "Intravenous; Parenteral",
        "form": "Injection, solution",
        "standing": "active",
        "regions": {
          "us": false,
          "canada": false,
          "eu": false,
          "germany": false,
          "colombia": false,
          "turkey": false,
          "italy": true,
          "malaysia": false,
          "austria": false,
          "indonesia": false,
          "thailand": false,
          "singapore": false
        },
        "rxnorm_concepts": [],
        "ingredients": [
          {
            "name": "Erythropoietin",
            "drug": {
              "name": "Erythropoietin",
              "drugbank_id": "DB00016"
            }
          }
        ]
      },
      "from": {
        "concept": {
          "title": "Anemia",
          "drugbank_id": "DBCOND0020261"
        },
        "indication": {
          "kind": "treatment_of",
          "off_label": false,
          "otc_use": false,
          "route": [
            "Intravenous",
            "Subcutaneous"
          ],
          "dose_form": [
            "Injection"
          ],
          "dose_strength": [],
          "timeline": "When chemotherapy is planned to last ≥2 months",
          "drug": {
            "name": "Darbepoetin alfa",
            "drugbank_id": "DB00012"
          },
          "regions": "US",
          "condition": {
            "name": "Anemia",
            "drugbank_id": "DBCOND0020261",
            "meddra_id": "pt/10002034",
            "snomed_id": "c/191277004",
            "icd10_id": "c/D64.9"
          },
          "condition_associated_with": [
            {
              "name": "Myelosuppressive chemotherapy",
              "drugbank_id": "DBCOND0020351"
            }
          ]
        }
      },
      "to": {
        "concept": {
          "title": "Anemia",
          "drugbank_id": "DBCOND0020261"
        },
        "indication": {
          "kind": "treatment_of",
          "off_label": false,
          "otc_use": false,
          "route": [
            "Intravenous",
            "Subcutaneous"
          ],
          "dose_form": [
            "Injection"
          ],
          "dose_strength": [],
          "drug": {
            "name": "Erythropoietin",
            "drugbank_id": "DB00016"
          },
          "regions": "US",
          "condition": {
            "name": "Anemia",
            "drugbank_id": "DBCOND0020261",
            "meddra_id": "pt/10002034",
            "snomed_id": "c/191277004",
            "icd10_id": "c/D64.9"
          },
          "condition_associated_with": [
            {
              "name": "Chronic Kidney Disease",
              "drugbank_id": "DBCOND0030403",
              "meddra_id": "llt/10064848",
              "snomed_id": "c/236425005",
              "icd10_id": "c/N18",
              "modification_of": {
                "base": {
                  "name": "Kidney Diseases",
                  "drugbank_id": "DBCOND0028223",
                  "meddra_id": "llt/10051051",
                  "snomed_id": "c/266627003",
                  "icd10_id": "c/N28.9"
                },
                "severity": {
                  "includes": [
                    "chronic"
                  ],
                  "excludes": []
                }
              }
            }
          ]
        }
      }
    },
    "..."
  ]
}

This endpoint retrieves a list of product concepts which have indications similar to the indications of the provided product concept.

The results are returned as a JSON object with a “similar_indications” property containing an array of objects representing similar product concepts. Each object in this array has three properties: product_concept (the similar product_concept), from, and to.

From and to describe the relationship between the input product concept and the similar product concept. From and to both contain the same two properties:

• concept, a condition object, and
• indication, an indication object.

HTTP Request

GET https://api.drugbank.com/v1/product_concepts/<ID>/similar_indications

URL Parameters

Parameter	Description
ID	The ID of the product concept for which to retrieve product concepts with similar indications

View Product Concept Adverse Effects

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

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/206824003",
      "icd10_id": "c/G24.9"
    },
    "patient_characteristics": [
      {
        "name": "Parkinson's Disease",
        "drugbank_id": "DBCOND0028039",
        "meddra_id": "llt/10034008",
        "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.drugbank.com/v1/product_concepts/<ID>/adverse_effects

URL Parameters

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

Query Parameters

Parameter	Default	Description
include_references	false	If true, includes the list of references for each adverse effect associated with this product concept. See References for details.

View Product Concept Contraindications

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

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": "llt/10058472",
        "snomed_id": "c/307760008",
        "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.drugbank.com/v1/product_concepts/<ID>/contraindications

URL Parameters

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

View Product Concept Boxed Warnings

curl -L 'https://api.drugbank.com/v1/product_concepts/DBPC0323661/boxed_warnings' 
-H 'Authorization: myapikey'

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

[
  {
    "drug": {
      "name": "Loxapine",
      "drugbank_id": "DB00408"
    },
    "kind": "warning",
    "lab_values": [],
    "route": [],
    "age_groups": [
      "seniors"
    ],
    "risk": {
      "name": "Increased mortality",
      "drugbank_id": "DBCOND0100456"
    },
    "patient_characteristics": [
      {
        "name": "Dementia-related Psychosis",
        "drugbank_id": "DBCOND0092686"
      }
    ]
  }
]

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

HTTP Request

GET https://api.drugbank.com/v1/product_concepts/<ID>/boxed_warnings

URL Parameters

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

View Product Concept Allergy Details

curl -L 'https://api.drugbank.com/v1/product_concepts/DBPC503562/allergy_details' 
-H 'Authorization: myapikey'

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

[
  {
    "drug": {
      "drugbank_id": "DB01060",
      "name": "Amoxicillin"
    },
    "details": [
      {
        "summary": "Hypersensitivity to Penicillins can present as: Cutaneous Manifestations of Drug Allergy and Erythema multiforme",
        "info": "Penicillin allergy is the most common drug allergy, with incidence ranging between five and 25% by geographical region and population...",
        "evidence_type": [
          "case_reports",
          "review"
        ],
        "hypersensitivity_types": [
          "Type IV",
          "Unclassified"
        ],
        "presentations": [
          "Cutaneous Manifestations of Drug Allergy",
          "Erythema multiforme"
        ]
      }
    ]
  }
]

This endpoint retrieves allergy information linked to components of a product concept.

Components with no associated allergy details will not show up. Allergy details for each component will show up as a list.

HTTP Request

GET https://api.drugbank.com/v1/product_concepts/<ID>/allergy_details

URL Parameters

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

Query Parameters

Parameter	Default	Description
include_presentation_details	false	If set to true, include details of each presentation.
include_source_details	false	If set to true, include source_name and source_type for this allergy detail (useful when there are multiple allergy details).
include_references	false	If true, includes the lists of references for allergy information. See References for details.

View Product Concept Cross-sensitivities

curl -L 'https://api.drugbank.com/v1/product_concepts/DBPC503562/cross_sensitivities' 
-H 'Authorization: myapikey'

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

[
  {
    "drug": {
      "name": "Amoxicillin",
      "drugbank_id": "DB01060"
    },
    "summary": "As a Penicillin, Amoxicillin is known to be cross-sensitive with Clavulanic acid",
    "description": "An allergy to clavulanic acid may lead to an allergy to other beta-lactams, such as penicillins and cephalosporins, due to similarities in chemical str...",
    "incidence": "Theoretical",
    "evidence_type": [
      "review"
    ],
    "cross_sensitive_drugs": [
      {
        "name": "Clavulanic acid",
        "drugbank_id": "DB00766"
      }
    ]
  }
]

This endpoint retrieves cross-sensitivity information linked to components of a product concept.

Components with no associated cross-sensitivities will not show up. Cross-sensitivities for each component will show up as a list.

HTTP Request

GET https://api.drugbank.com/v1/product_concepts/<ID>/cross_sensitivities

URL Parameters

Parameter	Description
ID	The ID of the product concept to retrieve the cross-sensitivities.

Query Parameters

Parameter	Default	Description
include_references	false	If true, includes the lists of references for cross-sensitivity information. See References for details.

View Product Concept Parents

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

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": "1999-10-07",
    "regions": {
      "us": true,
      "canada": true,
      "eu": true,
      "germany": true,
      "colombia": true,
      "turkey": true,
      "italy": true,
      "malaysia": true,
      "austria": true,
      "indonesia": true,
      "thailand": true,
      "singapore": 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 medication name 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.drugbank.com/v1/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.drugbank.com/v1/product_concepts/DBPC0001930/children' 
-H 'Authorization: myapikey'

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

[
  {
    "name": "Pantoprazole sodium 20 mg Oral Tablet, coated",
    "display_name": null,
    "drugbank_pcid": "DBPC0656321",
    "brand": null,
    "level": 5,
    "route": "Oral",
    "form": "Tablet, coated",
    "strengths": "20 mg",
    "standing": "active",
    "standing_updated_at": null,
    "standing_active_since": "1999-10-07",
    "regions": {
      "us": false,
      "canada": false,
      "eu": false,
      "germany": false,
      "colombia": false,
      "turkey": false,
      "italy": false,
      "malaysia": true,
      "austria": false,
      "indonesia": false,
      "thailand": false,
      "singapore": true
    },
    "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 medication name 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.drugbank.com/v1/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.drugbank.com/v1/product_concepts/rxnorm/6387' 
-H 'Authorization: myapikey'

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,
      "germany": false,
      "colombia": true,
      "turkey": true,
      "italy": true,
      "malaysia": true,
      "austria": true,
      "indonesia": true,
      "thailand": true,
      "singapore": true
    },
    "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.drugbank.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.drugbank.com/v1/product_concepts/DBPC0151796/revocation' 
-H 'Authorization: myapikey'

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 6.5 mg / Testosterone enanthate 100 mg /mL Intramuscular",
      "drugbank_pcid": "DBPC0734281",
      "regions": {
        "us": false,
        "canada": false,
        "eu": false,
        "germany": false,
        "colombia": false,
        "turkey": false,
        "italy": false,
        "malaysia": false,
        "austria": false,
        "indonesia": false,
        "thailand": false,
        "singapore": false
      }
    },
    {
      "name": "Estradiol valerate 6.5 mg / Testosterone enanthate 100 mg /mL Intramuscular Solution",
      "drugbank_pcid": "DBPC0734425",
      "regions": {
        "us": false,
        "canada": false,
        "eu": false,
        "germany": false,
        "colombia": false,
        "turkey": false,
        "italy": false,
        "malaysia": false,
        "austria": false,
        "indonesia": false,
        "thailand": false,
        "singapore": 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.drugbank.com/v1/product_concepts/<ID>/revocation

URL Parameters

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

Search duplicate therapies

curl -L 'https://api.drugbank.com/v1/product_concepts/duplicate_therapies?product_concept_id=DBPC0251172,DBPC0011839' 
-H 'Authorization: myapikey'

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

{
  "duplicate_ingredients": [
    {
      "drug": {
        "name": "Acetaminophen",
        "drugbank_id": "DB00316"
      },
      "product_concepts": [
        {
          "name": "Acetaminophen 500 mg Oral Tablet, film coated [Panadol]",
          "display_name": "Panadol 500 mg Oral Tablet, film coated",
          "drugbank_pcid": "DBPC0251172",
          "brand": "Panadol",
          "level": 5,
          "route": "Oral",
          "form": "Tablet, film coated",
          "strengths": "500 mg",
          "standing": "active",
          "standing_updated_at": "2018-09-12",
          "standing_active_since": "2011-03-18",
          "regions": {
            "us": true,
            "canada": false,
            "eu": false,
            "germany": false,
            "colombia": false,
            "turkey": false,
            "italy": false,
            "malaysia": false,
            "austria": false,
            "indonesia": false,
            "thailand": false,
            "singapore": false
          },
          "rxnorm_concepts": [
            {
              "name": "acetaminophen 500 MG Oral Tablet [Panadol]",
              "RXCUI": "200977"
            }
          ],
          "ingredients": [
            {
              "name": "Acetaminophen",
              "drug": {
                "name": "Acetaminophen",
                "drugbank_id": "DB00316"
              },
              "strength": {
                "amount": "500.0",
                "per": "1.0",
                "units": "mg"
              }
            }
          ]
        },
        {
          "name": "Acetaminophen 160 mg /5mL Oral Suspension",
          "display_name": null,
          "drugbank_pcid": "DBPC0011839",
          "brand": null,
          "level": 4,
          "route": "Oral",
          "form": "Suspension",
          "strengths": "160 mg /5mL",
          "standing": "active",
          "standing_updated_at": "2018-09-12",
          "standing_active_since": "1989-08-15",
          "regions": {
            "us": true,
            "canada": true,
            "eu": false,
            "germany": false,
            "colombia": false,
            "turkey": false,
            "italy": false,
            "malaysia": false,
            "austria": false,
            "indonesia": true,
            "thailand": true,
            "singapore": false
          },
          "rxnorm_concepts": [
            {
              "name": "acetaminophen 33.3 MG/ML Oral Solution",
              "RXCUI": "307684"
            },
            {
              "name": "acetaminophen 100 MG/ML Oral Solution",
              "RXCUI": "238159"
            },
            "..."
          ],
          "ingredients": [
            {
              "name": "Acetaminophen",
              "drug": {
                "name": "Acetaminophen",
                "drugbank_id": "DB00316"
              },
              "strength": {
                "amount": "160.0",
                "per": "5.0",
                "units": "mg/mL"
              }
            }
          ]
        }
      ]
    }
  ],
  "duplicate_therapies": [
    {
      "condition": {
        "title": "Severe Pain",
        "drugbank_id": "DBCOND0066540"
      },
      "kind": "treatment_of",
      "duplicates": [
        {
          "product_concept": {
            "name": "Acetaminophen 160 mg /5mL Oral Suspension",
            "display_name": null,
            "drugbank_pcid": "DBPC0011839",
            "brand": null,
            "level": 4,
            "route": "Oral",
            "form": "Suspension",
            "strengths": "160 mg /5mL",
            "standing": "active",
            "standing_updated_at": "2018-09-12",
            "standing_active_since": "1989-08-15",
            "regions": {
              "us": true,
              "canada": true,
              "eu": false,
              "germany": false,
              "colombia": false,
              "turkey": false,
              "italy": false,
              "malaysia": false,
              "austria": false,
              "indonesia": true,
              "thailand": true,
              "singapore": false
            },
            "rxnorm_concepts": [
              {
                "name": "acetaminophen 33.3 MG/ML Oral Solution",
                "RXCUI": "307684"
              },
              {
                "name": "acetaminophen 100 MG/ML Oral Solution",
                "RXCUI": "238159"
              },
              "..."
            ],
            "ingredients": [
              {
                "name": "Acetaminophen",
                "drug": {
                  "name": "Acetaminophen",
                  "drugbank_id": "DB00316"
                },
                "strength": {
                  "amount": "160.0",
                  "per": "5.0",
                  "units": "mg/mL"
                }
              }
            ]
          },
          "indication": {
            "kind": "adjunct_therapy_in_treatment_of",
            "off_label": false,
            "otc_use": false,
            "route": [],
            "dose_form": [],
            "dose_strength": [],
            "drug": {
              "name": "Acetaminophen",
              "drugbank_id": "DB00316"
            },
            "regions": "US",
            "condition": {
              "name": "Severe Pain",
              "drugbank_id": "DBCOND0066540",
              "icd10_id": "c/R52",
              "modification_of": {
                "base": {
                  "name": "Pain",
                  "drugbank_id": "DBCOND0012160",
                  "meddra_id": "llt/10033371",
                  "snomed_id": "c/162412006",
                  "icd10_id": "c/R52"
                },
                "severity": {
                  "includes": [
                    "severe"
                  ],
                  "excludes": []
                }
              }
            },
            "with_therapies": [
              {
                "name": "Opioids",
                "drugbank_id": "DBCOND0037703",
                "meddra_id": "llt/10063231",
                "snomed_id": "c/404642006"
              }
            ]
          }
        },
        {
          "product_concept": {
            "name": "Acetaminophen 500 mg Oral Tablet, film coated [Panadol]",
            "display_name": "Panadol 500 mg Oral Tablet, film coated",
            "drugbank_pcid": "DBPC0251172",
            "brand": "Panadol",
            "level": 5,
            "route": "Oral",
            "form": "Tablet, film coated",
            "strengths": "500 mg",
            "standing": "active",
            "standing_updated_at": "2018-09-12",
            "standing_active_since": "2011-03-18",
            "regions": {
              "us": true,
              "canada": false,
              "eu": false,
              "germany": false,
              "colombia": false,
              "turkey": false,
              "italy": false,
              "malaysia": false,
              "austria": false,
              "indonesia": false,
              "thailand": false,
              "singapore": false
            },
            "rxnorm_concepts": [
              {
                "name": "acetaminophen 500 MG Oral Tablet [Panadol]",
                "RXCUI": "200977"
              }
            ],
            "ingredients": [
              {
                "name": "Acetaminophen",
                "drug": {
                  "name": "Acetaminophen",
                  "drugbank_id": "DB00316"
                },
                "strength": {
                  "amount": "500.0",
                  "per": "1.0",
                  "units": "mg"
                }
              }
            ]
          },
          "indication": {
            "kind": "adjunct_therapy_in_treatment_of",
            "off_label": false,
            "otc_use": false,
            "route": [],
            "dose_form": [],
            "dose_strength": [],
            "drug": {
              "name": "Acetaminophen",
              "drugbank_id": "DB00316"
            },
            "regions": "US",
            "condition": {
              "name": "Severe Pain",
              "drugbank_id": "DBCOND0066540",
              "icd10_id": "c/R52",
              "modification_of": {
                "base": {
                  "name": "Pain",
                  "drugbank_id": "DBCOND0012160",
                  "meddra_id": "llt/10033371",
                  "snomed_id": "c/162412006",
                  "icd10_id": "c/R52"
                },
                "severity": {
                  "includes": [
                    "severe"
                  ],
                  "excludes": []
                }
              }
            },
            "with_therapies": [
              {
                "name": "Opioids",
                "drugbank_id": "DBCOND0037703",
                "meddra_id": "llt/10063231",
                "snomed_id": "c/404642006"
              }
            ]
          }
        }
      ]
    }
  ]
}

Check whether product concepts share the same ingredients or treat the same conditions.

Query Parameters

Parameter	Default	Description
product_concept_id		A comma-separated list of DrugBank product concept IDs

This returns two high level sections: duplicate_ingredients and duplicate_therapies.

duplicate_ingredients will return the entered product concepts grouped by their shared ingredients. Each entry of the array will contain the common drug and the product_concepts containing that drug.

duplicate_therapies will return the entered product concepts, along with their indications, grouped by the closest common condition that they treat. Each entry of the array will contain the common condition and kind and an array of duplicates. Entries in the duplicates array will be one of the entered product concepts along with the indication related to this condition.

Get the list of current FDA labels available for a product concept

curl -L 'https://api.drugbank.com/v1/product_concepts/DBPC0426158/labels' 
-H 'Authorization: myapikey'

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

[
  {
    "id": "7542bd88-13df-ee06-c3b2-3aad209e4fd0",
    "set_id": "0d3a966f-f937-05a8-a90f-5aa52ebbd613",
    "version": 12,
    "current": true,
    "title": "Zestoretic - lisinopril and hydrochlorothiazide TABLET",
    "product_type": "HUMAN PRESCRIPTION DRUG LABEL",
    "effective_on": "2021-07-01",
    "labeler_name": "Almatica Pharma Inc.",
    "first_product_marketing_started_on": "2015-04-15",
    "last_product_marketing_ended_on": null,
    "ndc_product_codes": [
      "52427-0437"
    ],
    "pmg_section_count": 1,
    "hpi_section_count": 18,
    "sli_section_count": 6,
    "all_section_count": 23
  }
]

This endpoint retrieves the list of current FDA labels for a product concept.

HTTP Request

GET https://api.drugbank.com/v1/product_concepts/<ID>/labels

View Drug Alternatives for a Product Concept

curl -L 'https://api.drugbank.com/v1/product_concepts/DBPC503562/therapeutic_alternatives' 
-H 'Authorization: myapikey'

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

[
  {
    "drugbank_id": "DB01060",
    "name": "Amoxicillin",
    "categories": [
      {
        "drugbank_id": "DBCAT003682",
        "name": "Aminopenicillins",
        "mesh_id": null,
        "mesh_tree_numbers": [],
        "atc_code": null,
        "atc_level": null,
        "categorization_kinds": [
          "therapeutic"
        ],
        "synonyms": [],
        "description": null,
        "drugs": [
          {
            "drugbank_id": "DB00415",
            "name": "Ampicillin"
          }
        ]
      },
      {
        "drugbank_id": "DBCAT000104",
        "name": "Anti-Bacterial Agents",
        "mesh_id": "D000900",
        "mesh_tree_numbers": [
          "D27.505.954.122.085"
        ],
        "atc_code": "S01AA",
        "atc_level": 4,
        "categorization_kinds": [
          "therapeutic",
          "pharmacological",
          "..."
        ],
        "synonyms": [
          "Agents, Anti-Bacterial",
          "Agents, Anti-Mycobacterial",
          "..."
        ],
        "description": "Substances produced by microorganisms that can inhibit or suppress the growth of other microorganisms.",
        "drugs": [
          {
            "drugbank_id": "DB00199",
            "name": "Erythromycin"
          },
          {
            "drugbank_id": "DB00452",
            "name": "Framycetin"
          },
          "..."
        ]
      },
      "..."
    ]
  }
]

This endpoint retrieves lists of drugs as therapeutic alternatives based on the therapeutic categorizations of the ingredients associated with the provided product concept.

Related product concepts to the drug alternatives can then be found using this endpoint.

HTTP Request

GET https://api.drugbank.com/v1/product_concepts/<ID>/therapeutic_alternatives

URL Parameters

Parameter	Description
ID	The ID of the product concept to retrieve the linked drug alternatives.

Drugs

Get a specific drug

curl -L 'https://api.drugbank.com/v1/drugs/DB00316' 
-H 'Authorization: myapikey'

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

{
  "drugbank_id": "DB00316",
  "name": "Acetaminophen",
  "cas_number": "103-90-2",
  "annotation_status": "complete",
  "availability_by_region": [
    {
      "region": "at",
      "max_phase": 4,
      "marketed_prescription": true,
      "generic_available": false,
      "pre_market_cancelled": false,
      "post_market_cancelled": false
    },
    {
      "region": "ca",
      "max_phase": 4,
      "marketed_prescription": true,
      "generic_available": true,
      "pre_market_cancelled": false,
      "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_description": "In general, acetaminophen is used for the treatment of mild to moderate pain and reduction of fever...",
    "pharmacodynamic_description": "Animal and clinical studies have determined that acetaminophen has both antipyretic and analgesic effects...",
    "mechanism_of_action_description": "According to its FDA labeling, acetaminophen's exact mechanism of action has not been fully established[Label] - despite this, it is often categorized ...",
    "absorption": "Acetaminophen has 88% oral bioavailability and reaches its highest plasma concentration 90 minutes after ingestion...",
    "protein_binding": "The binding of acetaminophen to plasma proteins is low (ranging from 10% to 25%), when given at therapeutic doses.[Label]",
    "volume_of_distribution": [
      "Volume of distribution is about 0..."
    ],
    "clearance": [
      "Adults: 0.27 L/h/kg following a 15 mg/kg intravenous (IV) dose.[Label]",
      "Children: 0.34 L/h/kg following a 15 mg/kg intravenous (IV dose).[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 by..."
  },
  "food_interactions": [
    "Avoid alcohol. Alcohol may increase the risk of hepatotoxicity.",
    "Take with or without food. The absorption is unaffected by food."
  ],
  "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",
    "atc_codes": [
      {
        "code": "N02BE71",
        "title": "paracetamol, combinations with psycholeptics",
        "combination": true
      },
      {
        "code": "N02BE01",
        "title": "paracetamol",
        "combination": false
      },
      "..."
    ]
  },
  "therapeutic_categories": [
    {
      "drugbank_id": "DBCAT000041",
      "name": "Analgesics",
      "mesh_id": "D000700",
      "mesh_tree_numbers": [
        "D27.505.696.663.850.014",
        "D27.505.954.427.040"
      ],
      "atc_code": "N02",
      "atc_level": 2,
      "synonyms": [
        "Agents, Analgesic",
        "Analgesic Agents",
        "..."
      ],
      "description": "Compounds that show activity in animal models of human PAIN such as tail flick and hot plate assays."
    },
    {
      "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."
    },
    "..."
  ]
}

This endpoint retrieves a specific drug based on DrugBank ID.

HTTP Request

GET https://api.drugbank.com/v1/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.drugbank.com/v1/drugs/DB00316/products' 
-H 'Authorization: myapikey'

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

[
  {
    "ndc_product_code": "52124-0111",
    "originator_ndc_product_code": "52124-0111",
    "dpd_id": null,
    "ema_product_code": null,
    "ema_ma_number": null,
    "pzn": null,
    "co_product_id": null,
    "tr_product_id": null,
    "it_product_id": null,
    "my_product_id": null,
    "at_product_id": null,
    "idn_product_id": null,
    "th_product_id": null,
    "sg_product_id": 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": "Ophthalmic; Oral; Topical",
    "application_number": "part333",
    "generic": false,
    "otc": true,
    "approved": false,
    "country": "US",
    "mixture": true,
    "allergenic": false,
    "cosmetic": false,
    "vaccine": false,
    "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": "DBCAT000021",
        "name": "Amino Acids, Peptides, and Proteins",
        "mesh_id": "D000602",
        "mesh_tree_numbers": [
          "D12"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [],
        "description": "Amino acids and chains of amino acids connected by peptide linkages."
      },
      {
        "drugbank_id": "DBCAT000021",
        "name": "Amino Acids, Peptides, and Proteins",
        "mesh_id": "D000602",
        "mesh_tree_numbers": [
          "D12"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [],
        "description": "Amino acids and chains of amino acids connected by peptide linkages."
      },
      "..."
    ],
    "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.drugbank.com/v1/drugs/<ID>/products

URL Parameters

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

Query Parameters

Parameter	Default	Description
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.

Filters

Products can be narrowed down by appending a filter to the url in the following format:

https://api.drugbank.com/v1/drugs/<ID>/products/<filter>

For example:

https://api.drugbank.com/v1/drugs/<ID>/products/generics

Filter	Description
generics	Returns only generic i.e. unbranded products.

Get product concepts linked with a drug

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

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

[
  {
    "name": "Acetaminophen 325 mg / Dextromethorphan 10 mg / Diphenhydramine 12.5 mg / Guaifenesin 200 mg / Phenylephrine 5 mg / Phenylephrine 5 mg Oral Kit",
    "display_name": null,
    "drugbank_pcid": "DBPC0795990",
    "brand": null,
    "level": 4,
    "route": "Oral",
    "form": "Kit",
    "strengths": "325 mg, 10 mg, 12.5 mg, 200 mg, 5 mg, 5 mg",
    "standing": "active",
    "standing_updated_at": null,
    "standing_active_since": "2018-12-15",
    "regions": {
      "us": true,
      "canada": false,
      "eu": false,
      "germany": false,
      "colombia": false,
      "turkey": false,
      "italy": false,
      "malaysia": false,
      "austria": false,
      "indonesia": false,
      "thailand": false,
      "singapore": false
    },
    "rxnorm_concepts": [],
    "ingredients": [
      {
        "name": "Phenylephrine",
        "drug": {
          "name": "Phenylephrine",
          "drugbank_id": "DB00388"
        },
        "strength": {
          "amount": "5.0",
          "per": "1.0",
          "units": "mg"
        }
      },
      {
        "name": "Guaifenesin",
        "drug": {
          "name": "Guaifenesin",
          "drugbank_id": "DB00874"
        },
        "strength": {
          "amount": "200.0",
          "per": "1.0",
          "units": "mg"
        }
      },
      "..."
    ]
  }
]

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.drugbank.com/v1/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.drugbank.com/v1/drugs/DB00993/categories' 
-H 'Authorization: myapikey'

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.drugbank.com/v1/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.drugbank.com/v1/drugs/DB00675/indications' 
-H 'Authorization: myapikey'

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

[
  {
    "kind": "used_in_combination_to_treat",
    "off_label": true,
    "otc_use": false,
    "route": [
      "Oral"
    ],
    "dose_form": [],
    "dose_strength": [],
    "combination_type": "regimen",
    "drug": {
      "name": "Tamoxifen",
      "drugbank_id": "DB00675"
    },
    "condition": {
      "name": "Desmoid tumour",
      "drugbank_id": "DBCOND0016232",
      "meddra_id": "llt/10059352",
      "snomed_id": "c/47284001",
      "icd10_id": "c/C49.9"
    },
    "combination_drugs": [
      {
        "name": "Sulindac",
        "drugbank_id": "DB00605"
      }
    ]
  }
]

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

HTTP Request

GET https://api.drugbank.com/v1/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.

View drugs with similar indications

curl -L 'https://api.drugbank.com/v1/drugs/DB00675/similar_indications' 
-H 'Authorization: myapikey'

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

{
  "similar_indications": [
    {
      "drug": {
        "name": "Anastrozole",
        "drugbank_id": "DB01217"
      },
      "from": {
        "concept": {
          "title": "Breast Cancer",
          "drugbank_id": "DBCOND0028036"
        },
        "indication": {
          "kind": "adjunct_therapy_in_prevention_of",
          "off_label": false,
          "otc_use": false,
          "route": [
            "Oral"
          ],
          "dose_form": [
            "Liquid",
            "Solution",
            "..."
          ],
          "dose_strength": [],
          "age_groups": [
            "adult"
          ],
          "drug": {
            "name": "Tamoxifen",
            "drugbank_id": "DB00675"
          },
          "regions": "US",
          "condition": {
            "name": "Contralateral Breast Cancer",
            "drugbank_id": "DBCOND0111583",
            "meddra_id": "llt/10054784",
            "snomed_id": "c/254837009",
            "icd10_id": "c/C50"
          },
          "condition_associated_with": [
            {
              "name": "Breast Cancer",
              "drugbank_id": "DBCOND0028036",
              "meddra_id": "llt/10006187",
              "snomed_id": "c/190121004",
              "icd10_id": "c/C50.9",
              "modification_of": {
                "location": "Breast",
                "base": {
                  "name": "Cancer",
                  "drugbank_id": "DBCOND0020966",
                  "meddra_id": "llt/10007050",
                  "snomed_id": "c/38807002",
                  "icd10_id": "c/C80.1"
                }
              }
            }
          ]
        }
      },
      "to": {
        "concept": {
          "title": "Advanced Breast Cancer",
          "drugbank_id": "DBCOND0031019"
        },
        "indication": {
          "kind": "treatment_of",
          "off_label": false,
          "otc_use": false,
          "sex_group": "female",
          "route": [
            "Oral"
          ],
          "dose_form": [],
          "dose_strength": [],
          "age_groups": [
            "postmenopausal"
          ],
          "drug": {
            "name": "Anastrozole",
            "drugbank_id": "DB01217"
          },
          "regions": "US",
          "condition": {
            "name": "Advanced Breast Cancer",
            "drugbank_id": "DBCOND0031019",
            "meddra_id": "llt/10072737",
            "snomed_id": "c/254837009",
            "icd10_id": "c/C50",
            "modification_of": {
              "condition_stage": "advanced",
              "base": {
                "name": "Breast Cancer",
                "drugbank_id": "DBCOND0028036",
                "meddra_id": "llt/10006187",
                "snomed_id": "c/190121004",
                "icd10_id": "c/C50.9"
              }
            }
          },
          "patient_characteristics": [
            {
              "name": "Disease progression with tamoxifen therapy",
              "drugbank_id": "DBCOND0100394"
            }
          ]
        }
      }
    },
    {
      "drug": {
        "name": "Estradiol",
        "drugbank_id": "DB00783"
      },
      "from": {
        "concept": {
          "title": "Breast Cancer",
          "drugbank_id": "DBCOND0028036"
        },
        "indication": {
          "kind": "adjunct_therapy_in_prevention_of",
          "off_label": false,
          "otc_use": false,
          "route": [
            "Oral"
          ],
          "dose_form": [
            "Liquid",
            "Solution",
            "..."
          ],
          "dose_strength": [],
          "age_groups": [
            "adult"
          ],
          "drug": {
            "name": "Tamoxifen",
            "drugbank_id": "DB00675"
          },
          "regions": "US",
          "condition": {
            "name": "Contralateral Breast Cancer",
            "drugbank_id": "DBCOND0111583",
            "meddra_id": "llt/10054784",
            "snomed_id": "c/254837009",
            "icd10_id": "c/C50"
          },
          "condition_associated_with": [
            {
              "name": "Breast Cancer",
              "drugbank_id": "DBCOND0028036",
              "meddra_id": "llt/10006187",
              "snomed_id": "c/190121004",
              "icd10_id": "c/C50.9",
              "modification_of": {
                "location": "Breast",
                "base": {
                  "name": "Cancer",
                  "drugbank_id": "DBCOND0020966",
                  "meddra_id": "llt/10007050",
                  "snomed_id": "c/38807002",
                  "icd10_id": "c/C80.1"
                }
              }
            }
          ]
        }
      },
      "to": {
        "concept": {
          "title": "Breast Cancer",
          "drugbank_id": "DBCOND0028036"
        },
        "indication": {
          "kind": "for_therapy",
          "off_label": false,
          "otc_use": false,
          "route": [
            "Subcutaneous"
          ],
          "dose_form": [
            "Pellet, implantable"
          ],
          "dose_strength": [],
          "drug": {
            "name": "Estradiol",
            "drugbank_id": "DB00783"
          },
          "regions": "Canada",
          "condition": {
            "name": "Breast Cancer",
            "drugbank_id": "DBCOND0028036",
            "meddra_id": "llt/10006187",
            "snomed_id": "c/190121004",
            "icd10_id": "c/C50.9",
            "modification_of": {
              "location": "Breast",
              "base": {
                "name": "Cancer",
                "drugbank_id": "DBCOND0020966",
                "meddra_id": "llt/10007050",
                "snomed_id": "c/38807002",
                "icd10_id": "c/C80.1"
              }
            }
          },
          "therapy": {
            "name": "Palliation",
            "drugbank_id": "DBCOND0126004",
            "meddra_id": "pt/10059513",
            "snomed_id": "c/103735009",
            "icd10_id": "c/Z51.5"
          }
        }
      }
    },
    "..."
  ]
}

This endpoint retrieves a list of drugs which have indications similar to the indications of the provided drug.

The results are returned as a JSON object with a “similar_indications” property containing an array of objects representing similar drugs. Each object in this array has three properties: drug (the similar drug), from, and to.

From and to describe the relationship between the input drug and the similar drug. From and to both contain the same two properties:

• concept, a condition object, and
• indication, an indication object.

HTTP Request

GET https://api.drugbank.com/v1/drugs/<ID>/similar_indications

URL Parameters

Parameter	Description
ID	The DrugBank ID of the drug for which to retrieve drugs with similar indications

Get drug-drug interactions for a drug

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

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": "",
    "affected_dosage": "",
    "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.drugbank.com/v1/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.
evidence_level	null	Limits results by the evidence level of the interactions. May be level_1 or level_2.
available_only	false	If true, only includes interactions with currently available drugs. If a region is specified, the drugs must also be available in that region.
include_references	false	If true, includes the references for each interaction. See References for details on the format.

Get adverse effects linked with a drug

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

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.drugbank.com/v1/drugs/<ID>/adverse_effects

URL Parameters

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

Query Parameters

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

Get contraindications linked with a drug

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

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

[
  {
    "route": [],
    "dose_form": [],
    "hypersensitivity": [
      "true"
    ],
    "lab_values": [],
    "recommended_actions": [],
    "regions": "US"
  },
  {
    "route": [],
    "dose_form": [],
    "hypersensitivity": [],
    "lab_values": [],
    "recommended_actions": [],
    "regions": "US",
    "patient_conditions": [
      {
        "name": "Severe, active Liver Disease",
        "drugbank_id": "DBCOND0112340",
        "modification_of": {
          "condition_status": "active",
          "base": {
            "name": "Liver Disease",
            "drugbank_id": "DBCOND0028338"
          },
          "severity": {
            "includes": [
              "severe"
            ],
            "excludes": []
          }
        }
      }
    ]
  },
  "..."
]

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

HTTP Request

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

URL Parameters

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

Get boxed warnings linked with a drug

curl -L 'https://api.drugbank.com/v1/drugs/DB00316/boxed_warnings' 
-H 'Authorization: myapikey'

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

[
  {
    "kind": "warning",
    "recommendation": "Do not exceed recommended daily maximum limits",
    "lab_values": [],
    "route": [],
    "dose_form": [],
    "risk": {
      "name": "Liver Failure",
      "drugbank_id": "DBCOND0031848",
      "meddra_id": "pt/10019663",
      "snomed_id": "c/235883002",
      "icd10_id": "c/K72.9"
    }
  },
  {
    "kind": "warning",
    "recommendation": "Do not exceed the maximum recommended daily dose of acetaminophen (by all routes of administration and all acetaminophen-containing products including ...",
    "lab_values": [],
    "route": [],
    "dose_form": [],
    "sex_group": "all",
    "risk": {
      "name": "Overdose",
      "drugbank_id": "DBCOND0014854",
      "meddra_id": "llt/10068719",
      "snomed_id": "d/92561019"
    },
    "with_drugs": [
      {
        "name": "Acetaminophen",
        "drugbank_id": "DB00316"
      }
    ]
  },
  "..."
]

This endpoint retrieves a list of boxed warnings (Black Box warnings) linked to a drug, based on DrugBank ID. This endpoint supports pagination.

HTTP Request

GET https://api.drugbank.com/v1/drugs/<ID>/boxed_warnings

URL Parameters

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

Get packages for a drug

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

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

[
  {
    "package_ndc_code": "16590-0023-90",
    "originator_package_ndc_code": "16590-023-90",
    "description": "90 TABLET IN 1 BOTTLE",
    "full_description": "90 TABLET 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",
    "originator_package_ndc_code": "21695-242-28",
    "description": "28 TABLET IN 1 BOTTLE",
    "full_description": "28 TABLET 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.drugbank.com/v1/drugs/<ID>/packages

URL Parameters

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

Get allergy details for a drug

curl -L 'https://api.drugbank.com/v1/drugs/DB09156/allergy_details' 
-H 'Authorization: myapikey'

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

[
  {
    "summary": "Hypersensitivity to Iopromide can present as: Stevens-Johnson Syndrome Toxic Epidermal Necrolysis Spectrum, Allergy-Induced Respiratory Symptoms, Angio...",
    "info": "Hypersensitivity reactions to iopromide tend to be rare in clinical practice...",
    "evidence_type": [
      "case_reports",
      "review"
    ],
    "hypersensitivity_types": [
      "Type I",
      "Type IV",
      "..."
    ],
    "presentations": [
      "Allergy-Induced Respiratory Symptoms",
      "Anaphylaxis",
      "..."
    ]
  }
]

This endpoint retrieves allergy information linked to a drug.

Details will be given as a list which may be empty if the drug has no associated allergy information.

HTTP Request

GET https://api.drugbank.com/v1/drugs/<ID>/allergy_details

URL Parameters

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

Query Parameters

Parameter	Default	Description
include_presentation_details	false	If set to true, include details of each presentation.
include_source_details	false	If set to true, include source_name and source_type for this allergy detail (useful when there are multiple allergy details).
include_references	false	If true, includes the lists of references for allergy information. See References for details.

Get cross-sensitivities for a drug

curl -L 'https://api.drugbank.com/v1/drugs/DB09156/cross_sensitivities' 
-H 'Authorization: myapikey'

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

[
  {
    "summary": "As an Iodine Radio-contrast Medium, Iopromide is known to be cross-sensitive with Iodine Radio-contrast Media",
    "description": "Iodine radio-contrast media hypersensitivity reactions may be due to broadly sensitive T cells, according to lymphocyte transferase tests...",
    "incidence": "67%",
    "evidence_type": [
      "case_reports",
      "review"
    ],
    "cross_sensitive_drugs": [
      {
        "name": "Acetrizoic acid",
        "drugbank_id": "DB09347"
      },
      {
        "name": "Diatrizoate",
        "drugbank_id": "DB00271"
      },
      "..."
    ]
  }
]

This endpoint retrieves cross-sensitivity information linked to a drug.

Cross-sensitivities will be given as a list which may be empty if the drug has no associated cross-sensitivities.

HTTP Request

GET https://api.drugbank.com/v1/drugs/<ID>/cross_sensitivities

URL Parameters

Parameter	Description
ID	The DrugBank ID of the drug to retrieve the cross-sensitivities.

Query Parameters

Parameter	Default	Description
include_references	false	If true, includes the lists of references for cross-sensitivity information. See References for details.

Get the list of current FDA labels available for a drug

curl -L 'https://api.drugbank.com/v1/drugs/DB00722/labels' 
-H 'Authorization: myapikey'

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

[
  {
    "id": "df48867f-2b60-3ab1-e053-2995a90ac654",
    "set_id": "57a6d044-a25e-443f-ab60-f9712b167a20",
    "version": 8,
    "current": true,
    "title": "LISINOPRIL - Lisinopril TABLET",
    "product_type": "HUMAN PRESCRIPTION DRUG LABEL",
    "effective_on": "2022-05-18",
    "labeler_name": "REMEDYREPACK INC.",
    "first_product_marketing_started_on": "2017-01-12",
    "last_product_marketing_ended_on": null,
    "ndc_product_codes": [
      "70518-0117"
    ],
    "pmg_section_count": 1,
    "hpi_section_count": 18,
    "sli_section_count": 9,
    "all_section_count": 28
  }
]

This endpoint retrieves the list of current FDA labels for a drug, linked through drug products.

HTTP Request

GET https://api.drugbank.com/v1/drugs/<ID>/labels

View Therapeutic Alternatives for a Drug

curl -L 'https://api.drugbank.com/v1/drugs/DB09156/therapeutic_alternatives' 
-H 'Authorization: myapikey'

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

[
  {
    "drugbank_id": "DBCAT003315",
    "name": "Radiographic Contrast Agent",
    "mesh_id": null,
    "mesh_tree_numbers": [],
    "atc_code": null,
    "atc_level": null,
    "categorization_kind": "therapeutic",
    "synonyms": [
      "Radiographic Contrast Agents",
      "Radiographic Contrast Drug",
      "..."
    ],
    "description": null,
    "drugs": [
      {
        "drugbank_id": "DB09135",
        "name": "Ioxilan"
      },
      {
        "drugbank_id": "DB00271",
        "name": "Diatrizoate"
      },
      "..."
    ]
  }
]

This endpoint retrieves lists of drugs as therapeutic alternatives based on the provided drug’s therapeutic categorizations.

The results are returned as individual categories where the provided drug is considered therapeutic for that category, each with a separate list of drug alternatives.

HTTP Request

GET https://api.drugbank.com/v1/drugs/<ID>/therapeutic_alternatives

URL Parameters

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

Drug-Drug Interactions

Provide a list of DrugBank drug ids to get a list of interactions between the given drugs, and/or a list of products to get a list of interactions between ingredients in the given products. Products can be specified by product concept ID or regional 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.

Note that this endpoint will look for interactions between any combination of query drugs/product ingredients, so be wary of using too many query terms as this can exponentially increase the number of results returned.

Drug-Drug Interactions (DDI) Plugin

Our DDI Plugin provides a “plug and play” alternative to implementing all of our “Find DDI” endpoints below:

As a standard web component, it is easy to integrate to suit your needs and comes with a number of available properties to fine-tune its functionality. This plugin can be used together with our Medication Search Plugin. For more information, please see this public repository.

Common Query Parameter Values

Return a list of drug interactions, including their references:

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

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": "",
      "affected_dosage": "",
      "evidence_level": "level_1",
      "management": "Avoid coadministration of ephedra with cyclopropane or halogenated hydrocarbon anesthetics whenever possible...",
      "references": {
        "literature_references": [
          {
            "ref_id": "A2417",
            "pubmed_id": 12916063,
            "citation": "Abourashed EA, El-Alfy AT, Khan IA, Walker L: Ephedra in perspective--a current review. Phytother Res. 2003 Aug;17(7):703-12."
          },
          {
            "ref_id": "A35004",
            "pubmed_id": 17594156,
            "citation": "Hahm TS, Lee JJ, Yang MK, Kim JA: Risk factors for an intraoperative arrhythmia during esophagectomy..."
          },
          "..."
        ],
        "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.
evidence_level	null	Limits results by the evidence level of the interactions. May be level_1 or level_2.
include_references	false	If true, includes the references for each interaction. See References for details on the format.

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	string	level_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.) level_2: Has been confirmed in at least 1 cohort, case-control, or case study and may or not be mentioned in a drug monograph.

Regional Products

Products are identified in different ways in different regions. Here is the list of unique identifier fields for all the currently supported regions.

Region	Region Code	Product ID Field	Local Product ID	Example
Austria	at	at_product_id	MA number	16965
Canada	ca	dpd	DIN	2341093
Colombia	co	co_product_id	Invima ID	INVIMA M-012422
European Union	eu	ema_ma_number	EU MA number	EU/1/04/276/001
European Union	eu	ema_product_code	Product number	EMEA/H/C/000471
Indonesia	idn	idn_product_id	Nomor registrasi	GKL0122234837A1
Italy	it	it_product_id	AIC	038835056
Malaysia	my	my_product_id	Registration no.	MAL12115054ACZ
Singapore	sg	sg_product_id	Licence no.	SIN11734P
Thailand	th	th_product_id	Registration no.	1C 95/60(N)
Turkey	tr	tr_product_id	Barcode	8699508150243
United States	us	ndc	9-digit NDC	0169-5174

Find DDI with Local Product ID

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

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

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": "",
      "affected_dosage": "",
      "evidence_level": "level_2",
      "management": "Monitor for reduced growth hormone efficacy..."
    }
  ],
  "total_results": 1
}

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

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

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": "",
      "affected_dosage": "",
      "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.drugbank.com/v1/ddi?<PRODUCT_ID_FIELD>=<LOCAL_PRODUCT_ID>,<LOCAL_PRODUCT_ID>

Query Parameters

Parameter	Description
<PRODUCT_ID_FIELD>	Product ID field from corresponding regions
<LOCAL_PRODUCT_ID>	A comma delimited list of Local Product IDs

Searching for local region codes outside of the specified regions is not supported.

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.drugbank.com/v1/ddi?product_concept_id=DBPC0248838,DBPC0061207' 
-H 'Authorization: myapikey'

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": "",
      "affected_dosage": "",
      "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.drugbank.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.drugbank.com/v1/ddi?drugbank_id=DB00497,DB01193' 
-H 'Authorization: myapikey'

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 known to be an inhibitor of CYP2D6 while the affected drug is reported to be metabolized by CYP2D6...",
      "action": "decrease_dynamics",
      "severity": "moderate",
      "subject_dosage": "",
      "affected_dosage": "",
      "evidence_level": "level_2",
      "management": "If concomitant therapy is required, patients should be monitored for adverse effects related to the affected drug..."
    }
  ],
  "total_results": 1
}

HTTP Request

GET https://api.drugbank.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 mixed input

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

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

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

{
  "interactions": [
    {
      "product_concept_id": "DBPC0024484",
      "product_concept_name": "Abacavir",
      "product_ingredient": {
        "drugbank_id": "DB01048",
        "name": "Abacavir"
      },
      "affected_product_ndc_product_code": [
        "00056-0173"
      ],
      "affected_product_name": "Coumadin",
      "affected_product_ingredient": {
        "drugbank_id": "DB00682",
        "name": "Warfarin"
      },
      "description": "Abacavir 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": "",
      "affected_dosage": "",
      "evidence_level": "level_2",
      "management": "Monitor the patient closely when these drugs are given concomitantly..."
    },
    {
      "product_concept_id": "DBPC0024484",
      "product_concept_name": "Abacavir",
      "product_ingredient": {
        "drugbank_id": "DB01048",
        "name": "Abacavir"
      },
      "affected_ingredient": {
        "drugbank_id": "DB01221",
        "name": "Ketamine"
      },
      "description": "Abacavir may decrease the excretion rate of Ketamine which could result in a higher serum level.",
      "extended_description": "The renal excretion of drugs is the overall result of a combination of processes in the kidneys that include glomerular filtration, passive diffusion, ...",
      "action": "decrease_excretion",
      "severity": "minor",
      "subject_dosage": "",
      "affected_dosage": "",
      "evidence_level": "level_2",
      "management": "Monitor the patient when such drugs are given concomitantly..."
    },
    "..."
  ],
  "total_results": 26
}

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

HTTP Request

POST https://api.drugbank.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 structured indications and conditions 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.

Data Types

The indications API uses the following data types:

• conditions
• structured indications
• product concepts
• genetic factors

Structured Indications

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

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

Property	Type	Description
off_label	boolean
otc_use	boolean
adjunct_use	boolean	When accessing via a product or product concept, true if the dbpc is directly related to the indication, otherwise false.
kind	string	Denotes the kind of use this indication describes.
timeline	string	Specifies the timeline (ex. short-term), if necessary.
route	string	Route of administration of the drug(s) in the indication.
dose_form	string	Dose form in which the indication applies.
dose_strength	string	Dose strength in which the indication applies.
regions	string array	A list of regions to which this indication applies.
sex_group	string	Denotes any restrictions of this indication based on patient sex. Possible values are null, “male”, “female”, or “all”.
min_age	object	This indication applies only to patients this age or older.
max_age	object	This indication applies only to patients this age or younger.
age_groups	string array	List of age groups to which this indication applies.
excluded_age_groups	string array	List of age groups to which this indication does not apply.
genetic_factors	Genetic Factor array
genetic_factors.includes	Genetic Factor array
genetic_factors.excludes	Genetic Factor array
combination_drugs	simplified Drug array	Denotes drugs administered in combination for this indication.
adjunct_drugs	simplified Drug array	Denotes drugs administered in adjunct for this indication.
combination_drug_categories	simplified Category array	Denotes drug categories administered in combination for this indication.
adjunct_drug_categories	simplified Category array	Denotes drug categories administered in adjunct for this indication.
combination_type	string	Describes how the indication combines drugs.

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

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

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

Property	Type	Description
condition	Condition	The condition which is the target of this indication.
induction_of	Condition	A condition which is induced by the drug.
process	Condition	Denotes a diagnosic process in diagnost indications.
therapy	Condition	Describes a therapy which is provided by this drug.
mechanism	Condition	Denotes the mechanism through which this drug achieves/contributes to the desired change.
condition_associated_with	Condition array
equivalent_concept	Condition	A condition equivalent to the indication. Some indications can be directly mapped to MedDRA or ICD10 concepts.
with_therapies	Condition array	Denotes adjunct therapies in adjunct indications.
patient_characteristics	Condition array	List of one or more patient characteristics. Example: “immunocompromised”
excluded_patient_characteristic	Condition array	List of characteristics which exclude patients from this indication.

combination_type

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

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

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

Genetic Factors

Describes a genetic factor for indications, or conditions.

Property	Type	Description
gene	Condition
mutation	Condition
positive_finding	Condition
negative_finding	Condition
related_genes	Condition array

Search indications

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

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

[
  {
    "kind": "used_in_combination_for_symptomatic_treatment_of",
    "off_label": false,
    "otc_use": true,
    "route": [
      "Topical"
    ],
    "dose_form": [],
    "dose_strength": [],
    "combination_type": "product",
    "drug": {
      "name": "Menthyl salicylate",
      "drugbank_id": "DB11201"
    },
    "regions": "US",
    "condition": {
      "name": "Arthritis",
      "drugbank_id": "DBCOND0016433",
      "meddra_id": "pt/10003246",
      "snomed_id": "c/363178003",
      "icd10_id": "c/M19.90"
    },
    "combination_drugs": [
      {
        "name": "Levomenthol",
        "drugbank_id": "DB00825"
      }
    ]
  }
]

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.drugbank.com/v1/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.

Get Drugs By Indications Search

curl -L 'https://api.drugbank.com/v1/indications/drugs?q=arthritis' 
-H 'Authorization: myapikey'

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

[
  {
    "drugbank_id": "DB11201",
    "name": "Menthyl salicylate",
    "cas_number": "89-46-3",
    "annotation_status": "complete",
    "availability_by_region": [
      {
        "region": "at",
        "max_phase": 0,
        "marketed_prescription": false,
        "generic_available": false,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      {
        "region": "ca",
        "max_phase": 4,
        "marketed_prescription": false,
        "generic_available": false,
        "pre_market_cancelled": false,
        "post_market_cancelled": true
      },
      "..."
    ],
    "description": "Menthyl salicylate is an ester of menthol and salicylic acid [L2808]...",
    "simple_description": null,
    "clinical_description": null,
    "synonyms": [
      "1-Menthyl salicylate",
      "Menthyl salicylate, (+/-)-"
    ],
    "pharmacology": {
      "indication_description": "\r\n\r\nFor the temporary relief of pain associated with rheumatism, arthritis, neuralgia, sprains and strains of joints and muscles, lumbago and fibrositi...",
      "pharmacodynamic_description": "Menthol and methyl salicylate are known as counterirritants...",
      "mechanism_of_action_description": "\r\nMenthol dilates the blood vessels causing a sensation of coldness, followed by an analgesic effect...",
      "absorption": "May be absorbed through intact skin...",
      "protein_binding": "",
      "volume_of_distribution": [],
      "clearance": [],
      "half_life": "",
      "route_of_elimination": "",
      "toxicity_description": "Salicylate intoxication may occur after ingestion or topical application of menthyl salicylate..."
    },
    "food_interactions": [],
    "identifiers": {
      "drugbank_id": "DB11201",
      "inchi": "InChI=1S/C17H24O3/c1-11(2)13-9-8-12(3)10-16(13)20-17(19)14-6-4-5-7-15(14)18/h4-7,11-13,16,18H,8-10H2,1-3H3/t12-,13+,16-/m1/s1",
      "inchikey": "SJOXEWUZWQYCGL-DVOMOZLQSA-N",
      "atc_codes": []
    },
    "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 based on a search of conditions and related indications. This endpoint supports pagination.

HTTP Request

GET https://api.drugbank.com/v1/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.drugbank.com/v1/indications/drugs?q=autoimmune+disorders&more=specific' 
-H 'Authorization: myapikey'

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

[
  {
    "drugbank_id": "DB00531",
    "name": "Cyclophosphamide",
    "cas_number": "50-18-0",
    "annotation_status": "complete",
    "availability_by_region": [
      {
        "region": "at",
        "max_phase": 0,
        "marketed_prescription": true,
        "generic_available": false,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      {
        "region": "ca",
        "max_phase": 4,
        "marketed_prescription": true,
        "generic_available": false,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      "..."
    ],
    "description": "Precursor of an alkylating nitrogen mustard antineoplastic and immunosuppressive agent that must be activated in the liver to form the active aldophosp...",
    "simple_description": "A medication used to treat certain cancers.",
    "clinical_description": "A nitrogen mustard used to treat lymphomas, myelomas, leukemia, mycosis fungoides, neuroblastoma, ovarian adenocarcinoma, retinoblastoma, and breast ca...",
    "synonyms": [
      "(+-)-Cyclophosphamide",
      "(RS)-Cyclophosphamide",
      "..."
    ],
    "pharmacology": {
      "indication_description": "Cyclophosphamide is indicated for the treatment of malignant lymphomas, multiple myeloma, leukemias, mycosis fungoides (advanced disease), neuroblastom...",
      "pharmacodynamic_description": "Cyclophosphamide is an antineoplastic in the class of alkylating agents and is used to treat various forms of cancer...",
      "mechanism_of_action_description": "Alkylating agents work by three different mechanisms: 1) attachment of alkyl groups to DNA bases, resulting in the DNA being fragmented by repair enzym...",
      "absorption": "After oral administration, peak concentrations occur at one hour. ",
      "protein_binding": "20% of cyclophosphamide is protein bound with no dose dependent changes. Some metabolites are protein bound to an extent greater than 60%. ",
      "volume_of_distribution": [
        "30-50 L"
      ],
      "clearance": [
        "Total body clearance = 63 ± 7.6 L/kg."
      ],
      "half_life": "3-12 hours",
      "route_of_elimination": "Cyclophosphamide is eliminated primarily in the form of metabolites...",
      "toxicity_description": "Adverse reactions reported most often include neutropenia, febrile neutropenia, fever, alopecia, nausea, vomiting, and diarrhea.\r\n"
    },
    "food_interactions": [
      "Drink plenty of fluids. Drink 2 to 3 liters of fluids a day.",
      "Take with food. Food reduces irritation."
    ],
    "identifiers": {
      "drugbank_id": "DB00531",
      "inchi": "InChI=1S/C7H15Cl2N2O2P/c8-2-5-11(6-3-9)14(12)10-4-1-7-13-14/h1-7H2,(H,10,12)",
      "inchikey": "CMSMOCZEIVJLDB-UHFFFAOYSA-N",
      "atc_codes": [
        {
          "code": "L01AA01",
          "title": "cyclophosphamide",
          "combination": false
        }
      ]
    },
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT003311",
        "name": "Alkylating Drugs",
        "mesh_id": "D000477",
        "mesh_tree_numbers": [
          "D27.505.519.124",
          "D27.888.569.035"
        ],
        "atc_code": "L01A",
        "atc_level": 3,
        "synonyms": [
          "Agents, Alkylating",
          "Alkylating Agent",
          "..."
        ],
        "description": "Highly reactive chemicals that introduce alkyl radicals into biologically active molecules and thereby prevent their proper functioning..."
      },
      {
        "drugbank_id": "DBCAT000024",
        "name": "Antineoplastic Agents",
        "mesh_id": "D000970",
        "mesh_tree_numbers": [
          "D27.505.954.248"
        ],
        "atc_code": "L01",
        "atc_level": 2,
        "synonyms": [
          "Agents, Anticancer",
          "Agents, Antineoplastic",
          "..."
        ],
        "description": "Substances that inhibit or prevent the proliferation of NEOPLASMS."
      },
      "..."
    ]
  }
]

HTTP Request

GET https://api.drugbank.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.

Data Types

The conditions API uses the following data types:

• conditions
• structured indications

Conditions

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

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

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

Condition objects have the following properties

Property	Type	Description
title	string	Name/description of the condition
drugbank_id	string	DrugBank id for the product concept.
meddra_id	string	MedDRA identifier
icd10_id	string	ICD10 identifier
snomed_id	string	SNOMED identifier
uniprot_id	string	UniProt identifer, for conditions which describe a gene.
related_concepts	Condition array
as_drug	Drug	The DrugBank drug of the same name as this condition, if any exists.
as_drug_category	Category	The DrugBank drug category of the same name as this condition, if any exists.
modification_of	Object	See below
combination_of	Object	See below

combination_of

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

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

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

Property	Type	Description
caused_by	Condition array
included_conditions	Condition array
excluded_conditions	Condition array
additional_characteristics	Condition array	Characteristic of the combination condition.

modification_of

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

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

Property	Type	Description
base	Condition	The base condition which is being modified.
location	string
condition_stage	string
condition_status	string
severity	object
severity.includes	string array
severity.excludes	string array

Search conditions

curl -L 'https://api.drugbank.com/v1/conditions?q=arth' 
-H 'Authorization: myapikey'

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

[
  {
    "hits": [
      {
        "field": "general title",
        "value": "<em>Arth</em>ritis/<em>Arth</em>rosis"
      }
    ],
    "name": "Arthritis/Arthrosis",
    "drugbank_id": "DBCOND0086825",
    "uniprot_id": null,
    "meddra_id": null,
    "icd10_id": null,
    "snomed_id": null
  },
  {
    "hits": [
      {
        "field": "general title",
        "value": "<em>Arth</em>ritis and <em>Arth</em>ralgia"
      }
    ],
    "name": "Arthritis and Arthralgia",
    "drugbank_id": "DBCOND0142150",
    "uniprot_id": null,
    "meddra_id": null,
    "icd10_id": null,
    "snomed_id": null
  },
  "..."
]

This endpoint returns a list of conditions suitable for use with autocomplete forms based on a query string. This endpoint supports pagination.

HTTP Request

GET https://api.drugbank.com/v1/conditions

Query Parameters

Parameter	Default	Description
q	“”	Text used to search conditions by name.
fuzzy	false	If set to true, enable fuzzy search (see fuzzy searching).
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

This endpoint retrieves a specific condition based on ID (DrugBank Condition ID).

curl -L 'https://api.drugbank.com/v1/conditions/DBCOND0015777' 
-H 'Authorization: myapikey'

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

{
  "name": "Gout",
  "drugbank_id": "DBCOND0015777",
  "meddra_id": "llt/10018634",
  "snomed_id": "d/309672015",
  "icd10_id": "c/M10.9",
  "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": "Refractory Gout",
      "drugbank_id": "DBCOND0025787"
    },
    {
      "name": "Chronic, refractory Gout",
      "drugbank_id": "DBCOND0112054",
      "icd10_id": "c/M1A.9"
    },
    "..."
  ],
  "indications": [
    {
      "kind": "management_of",
      "off_label": true,
      "otc_use": false,
      "drug": {
        "name": "Ibuprofen",
        "drugbank_id": "DB01050"
      },
      "condition": {
        "name": "Gout",
        "drugbank_id": "DBCOND0015777",
        "meddra_id": "llt/10018634",
        "snomed_id": "d/309672015",
        "icd10_id": "c/M10.9"
      }
    },
    {
      "kind": "treatment_of",
      "off_label": false,
      "otc_use": false,
      "route": [
        "Oral"
      ],
      "dose_form": [
        "Tablet"
      ],
      "dose_strength": [],
      "drug": {
        "name": "Probenecid",
        "drugbank_id": "DB01032"
      },
      "regions": "US",
      "condition": {
        "name": "Hyperuricemia",
        "drugbank_id": "DBCOND0004938",
        "meddra_id": "pt/10020903",
        "snomed_id": "c/271198001",
        "icd10_id": "c/E79.0"
      },
      "condition_associated_with": [
        {
          "name": "Gout",
          "drugbank_id": "DBCOND0015777",
          "meddra_id": "llt/10018634",
          "snomed_id": "d/309672015",
          "icd10_id": "c/M10.9"
        }
      ]
    },
    "..."
  ]
}

URL Parameters

Parameter	Description
ID	The ID of the condition to retrieve.

Get indications linked to a condition

curl -L 'https://api.drugbank.com/v1/conditions/DBCOND0015777/indications' 
-H 'Authorization: myapikey'

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

[
  {
    "kind": "management_of",
    "off_label": true,
    "otc_use": false,
    "drug": {
      "name": "Ibuprofen",
      "drugbank_id": "DB01050"
    },
    "condition": {
      "name": "Gout",
      "drugbank_id": "DBCOND0015777",
      "meddra_id": "llt/10018634",
      "snomed_id": "d/309672015",
      "icd10_id": "c/M10.9"
    }
  },
  {
    "kind": "treatment_of",
    "off_label": false,
    "otc_use": false,
    "route": [
      "Oral"
    ],
    "dose_form": [
      "Tablet"
    ],
    "dose_strength": [],
    "drug": {
      "name": "Probenecid",
      "drugbank_id": "DB01032"
    },
    "regions": "US",
    "condition": {
      "name": "Hyperuricemia",
      "drugbank_id": "DBCOND0004938",
      "meddra_id": "pt/10020903",
      "snomed_id": "c/271198001",
      "icd10_id": "c/E79.0"
    },
    "condition_associated_with": [
      {
        "name": "Gout",
        "drugbank_id": "DBCOND0015777",
        "meddra_id": "llt/10018634",
        "snomed_id": "d/309672015",
        "icd10_id": "c/M10.9"
      }
    ]
  },
  "..."
]

This endpoint retrieves indications linked to a condition.

HTTP Request

GET https://api.drugbank.com/v1/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.drugbank.com/v1/conditions/DBCOND0015777/product_concepts' 
-H 'Authorization: myapikey'

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

[
  {
    "name": "Ibuprofen",
    "display_name": null,
    "drugbank_pcid": "DBPC0011945",
    "brand": null,
    "level": 1,
    "route": null,
    "form": null,
    "strengths": null,
    "standing": "active",
    "standing_updated_at": "2018-09-12",
    "standing_active_since": "1972-12-31",
    "regions": {
      "us": true,
      "canada": true,
      "eu": true,
      "germany": true,
      "colombia": true,
      "turkey": true,
      "italy": true,
      "malaysia": true,
      "austria": true,
      "indonesia": true,
      "thailand": true,
      "singapore": true
    },
    "rxnorm_concepts": [
      {
        "name": "ibuprofen",
        "RXCUI": "5640"
      }
    ],
    "ingredients": [
      {
        "name": "Ibuprofen",
        "drug": {
          "name": "Ibuprofen",
          "drugbank_id": "DB01050"
        }
      }
    ]
  },
  {
    "name": "Probenecid Oral Tablet, coated",
    "display_name": null,
    "drugbank_pcid": "DBPC0607294",
    "brand": null,
    "level": 3,
    "route": "Oral",
    "form": "Tablet, coated",
    "strengths": null,
    "standing": "active",
    "standing_updated_at": null,
    "standing_active_since": "2010-08-02",
    "regions": {
      "us": false,
      "canada": false,
      "eu": false,
      "germany": false,
      "colombia": false,
      "turkey": false,
      "italy": false,
      "malaysia": false,
      "austria": false,
      "indonesia": false,
      "thailand": true,
      "singapore": false
    },
    "rxnorm_concepts": [],
    "ingredients": [
      {
        "name": "Probenecid",
        "drug": {
          "name": "Probenecid",
          "drugbank_id": "DB01032"
        }
      }
    ]
  },
  "..."
]

This endpoint retrieves product concepts linked to a condition.

HTTP Request

GET https://api.drugbank.com/v1/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.drugbank.com/v1/conditions/DBCOND0012160/drugs' 
-H 'Authorization: myapikey'

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

[
  {
    "drugbank_id": "DB00852",
    "name": "Pseudoephedrine",
    "cas_number": "90-82-4",
    "annotation_status": "complete",
    "availability_by_region": [
      {
        "region": "at",
        "max_phase": 0,
        "marketed_prescription": true,
        "generic_available": false,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      {
        "region": "ca",
        "max_phase": 4,
        "marketed_prescription": true,
        "generic_available": true,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      "..."
    ],
    "description": "Pseudoephedrine is structurally related to [ephedrine] but exerts a weaker effect on the sympathetic nervous system...",
    "simple_description": "A medication used to treat congestion and a runny nose.",
    "clinical_description": "An alpha and beta adrenergic agonist used to treat nasal and sinus congestion, as well as allergic rhinitis.",
    "synonyms": [
      "(+) threo-2-(methylamino)-1-phenyl-1-propanol",
      "(+)-(1S,2S)-Pseudoephedrine",
      "..."
    ],
    "pharmacology": {
      "indication_description": "Pseudoephedrine is a sympathomimetic amine used for its decongestant activity.[L11031,L11037,L11040,L11046,L11052,L11058,L11061]",
      "pharmacodynamic_description": "Pseudoephedrine causes vasoconstriction which leads to a decongestant effect...",
      "mechanism_of_action_description": "Pseudoephedrine acts mainly as an agonist of alpha adrenergic receptors[A189381] and less strongly as an agonist of beta adrenergic receptors...",
      "absorption": "A 240mg oral dose of pseudoephedrine reaches a C<sub>max</sub> of 246...",
      "protein_binding": "-pseudoephedrine is 6...",
      "volume_of_distribution": [
        "The apparent volume of distribution of pseudoephedrin is 2.6-3.3L/kg.[L11031]"
      ],
      "clearance": [
        "A 60mg oral dose of pseudoephedrine has a clearance of 5.9±1.7mL/min/kg.[L11040]"
      ],
      "half_life": "The mean elimination half life of pseudoephedrine is 6.0h.[L11031]",
      "route_of_elimination": "55-75% of an oral dose is detected in the urine as unchanged pseudoephedrine.[L11040]",
      "toxicity_description": "The oral LD<sub>50</sub> of pseudoephedrine is 2206mg/kg in rats and 726mg/kg in mice..."
    },
    "food_interactions": [
      "Take with or without food. The absorption is unaffected by food."
    ],
    "identifiers": {
      "drugbank_id": "DB00852",
      "inchi": "InChI=1S/C10H15NO/c1-8(11-2)10(12)9-6-4-3-5-7-9/h3-8,10-12H,1-2H3/t8-,10+/m0/s1",
      "inchikey": "KWGRBVOPPLSCSI-WCBMZHEXSA-N",
      "atc_codes": [
        {
          "code": "R01BA52",
          "title": "pseudoephedrine, combinations",
          "combination": true
        },
        {
          "code": "R01BA02",
          "title": "pseudoephedrine",
          "combination": false
        }
      ]
    },
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000537",
        "name": "Adrenergic Agonists",
        "mesh_id": "D000322",
        "mesh_tree_numbers": [
          "D27.505.519.625.050.100",
          "D27.505.696.577.050.100"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Adrenergic Agonist",
          "Adrenergic Receptor Agonist",
          "..."
        ],
        "description": "Drugs that bind to and activate adrenergic receptors."
      },
      {
        "drugbank_id": "DBCAT000538",
        "name": "Adrenergic alpha-1 Receptor Agonists",
        "mesh_id": "D058646",
        "mesh_tree_numbers": [
          "D27.505.519.625.050.100.100.100",
          "D27.505.696.577.050.100.100.100"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Adrenergic alpha 1 Agonists",
          "Adrenergic alpha 1 Receptor Agonist",
          "..."
        ],
        "description": "Compounds that bind to and activate ADRENERGIC ALPHA-1 RECEPTORS."
      },
      "..."
    ]
  },
  {
    "drugbank_id": "DB00371",
    "name": "Meprobamate",
    "cas_number": "57-53-4",
    "annotation_status": "complete",
    "availability_by_region": [
      {
        "region": "at",
        "max_phase": 0,
        "marketed_prescription": false,
        "generic_available": false,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      {
        "region": "ca",
        "max_phase": 4,
        "marketed_prescription": true,
        "generic_available": true,
        "pre_market_cancelled": false,
        "post_market_cancelled": true
      },
      "..."
    ],
    "description": "A carbamate with hypnotic, sedative, and some muscle relaxant properties, although in therapeutic doses reduction of anxiety rather than a direct effec...",
    "simple_description": "A medication used to provide short term relief of anxiety symptoms.",
    "clinical_description": "An anxiolytic drug used for the short-term management of anxiety symptoms.",
    "synonyms": [
      "Meprobamat",
      "Meprobamate",
      "..."
    ],
    "pharmacology": {
      "indication_description": "For the management of anxiety disorders or for the short-term relief of the symptoms of anxiety.",
      "pharmacodynamic_description": "Meprobamate is an anxiolytic drug...",
      "mechanism_of_action_description": "Meprobamate's mechanism of action is not fully understood; in animal studies, meprobamate is reported to act at multiple sites in the central nervous s...",
      "absorption": "Well absorbed from the gastrointestinal tract.",
      "protein_binding": "",
      "volume_of_distribution": [],
      "clearance": [],
      "half_life": "Plasma half-life is about 10 hours.",
      "route_of_elimination": "",
      "toxicity_description": "Symptoms of overdose include coma, drowsiness, loss of muscle control, severely impaired breathing, shock, sluggishness, and unresponsiveness..."
    },
    "food_interactions": [
      "Avoid alcohol.",
      "Take with or without food. Food does not significantly affect absorption."
    ],
    "identifiers": {
      "drugbank_id": "DB00371",
      "inchi": "InChI=1S/C9H18N2O4/c1-3-4-9(2,5-14-7(10)12)6-15-8(11)13/h3-6H2,1-2H3,(H2,10,12)(H2,11,13)",
      "inchikey": "NPPQSCRMBWNHMW-UHFFFAOYSA-N",
      "atc_codes": [
        {
          "code": "N05BC51",
          "title": "meprobamate, combinations",
          "combination": true
        },
        {
          "code": "N05CX01",
          "title": "meprobamate, combinations",
          "combination": true
        },
        "..."
      ]
    },
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000399",
        "name": "Central Nervous System Depressants",
        "mesh_id": "D002492",
        "mesh_tree_numbers": [
          "D27.505.696.277",
          "D27.505.954.427.210"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "CNS Depressants",
          "Depressants, CNS"
        ],
        "description": "A very loosely defined group of drugs that tend to reduce the activity of the central nervous system..."
      },
      {
        "drugbank_id": "DBCAT000452",
        "name": "Hypnotics and Sedatives",
        "mesh_id": "D006993",
        "mesh_tree_numbers": [
          "D27.505.696.277.350",
          "D27.505.954.427.210.350"
        ],
        "atc_code": "N05C",
        "atc_level": 3,
        "synonyms": [
          "Effect, Hypnotic",
          "Effect, Sedative",
          "..."
        ],
        "description": "Drugs used to induce drowsiness or sleep or to reduce psychological excitement or anxiety."
      },
      "..."
    ]
  },
  "..."
]

This endpoint retrieves drugs linked to a condition via indications.

HTTP Request

GET https://api.drugbank.com/v1/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.drugbank.com/v1/conditions/DBCOND0015777/general' 
-H 'Authorization: myapikey'

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.drugbank.com/v1/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.drugbank.com/v1/conditions/DBCOND0015777/specific' 
-H 'Authorization: myapikey'

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

[
  {
    "name": "Refractory Gout",
    "drugbank_id": "DBCOND0025787",
    "modification_of": {
      "base": {
        "name": "Gout",
        "drugbank_id": "DBCOND0015777",
        "meddra_id": "llt/10018634",
        "snomed_id": "d/309672015",
        "icd10_id": "c/M10.9"
      },
      "severity": {
        "includes": [
          "refractory"
        ],
        "excludes": []
      }
    },
    "combination_of": {
      "additional_characteristics": [
        "Refractory"
      ],
      "included_conditions": [
        {
          "name": "Gout",
          "drugbank_id": "DBCOND0015777",
          "meddra_id": "llt/10018634",
          "snomed_id": "d/309672015",
          "icd10_id": "c/M10.9"
        }
      ]
    }
  },
  {
    "name": "Refractory Chronic Gout",
    "drugbank_id": "DBCOND0116735",
    "icd10_id": "c/M1A.9",
    "modification_of": {
      "base": {
        "name": "Refractory Gout",
        "drugbank_id": "DBCOND0025787"
      },
      "severity": {
        "includes": [
          "chronic"
        ],
        "excludes": []
      }
    }
  },
  "..."
]

This endpoint retrieves more specific forms of a condition.

HTTP Request

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

URL Parameters

Parameter	Description
ID	The ID of the condition to retrieve.

Get related conditions

curl -L 'https://api.drugbank.com/v1/conditions/DBCOND0023821/references' 
-H 'Authorization: myapikey'

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

[
  {
    "name": "Inflammation",
    "drugbank_id": "DBCOND0012215",
    "meddra_id": "llt/10021995",
    "snomed_id": "c/23583003"
  },
  {
    "name": "Pain",
    "drugbank_id": "DBCOND0012160",
    "meddra_id": "llt/10033371",
    "snomed_id": "c/162412006",
    "icd10_id": "c/R52"
  }
]

This endpoint retrieves related conditions.

HTTP Request

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

URL Parameters

Parameter	Description
ID	The ID of the condition to retrieve.

ICD-10

ICD-10 Search

curl -L 'https://api.drugbank.com/v1/icd10?q=ameb' 
-H 'Authorization: myapikey'

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

[
  {
    "hits": [
      {
        "field": "includes",
        "value": "<em>Ameb</em>ic balanitis"
      },
      {
        "field": "description",
        "value": "Other <em>ameb</em>ic genitourinary infections"
      }
    ],
    "identifier": "A06.82",
    "description": "Other amebic genitourinary infections"
  },
  {
    "hits": [
      {
        "field": "includes",
        "value": "<em>Ameb</em>oma NOS"
      },
      {
        "field": "description",
        "value": "<em>Ameb</em>oma of intestine"
      }
    ],
    "identifier": "A06.3",
    "description": "Ameboma of intestine"
  },
  "..."
]

This endpoint searches for ICD-10 concepts: either using the ICD-10 code itself, or by the concept description or inclusion terms. This search is compatible with autocomplete forms and fuzzy search.

HTTP Request

GET https://api.drugbank.com/v1/icd10

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).

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 while the hits array includes matches to inclusion terms, the ICD-10 concepts returned are limited to the identifier and description.

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.drugbank.com/v1/categories/DBCAT001220' 
-H 'Authorization: myapikey'

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.drugbank.com/v1/categories/<ID>

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

GET https://api.drugbank.com/v1/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.drugbank.com/v1/categories/atc/L01' 
-H 'Authorization: myapikey'

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.drugbank.com/v1/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.drugbank.com/v1/categories/mesh/D015122' 
-H 'Authorization: myapikey'

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.drugbank.com/v1/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.drugbank.com/v1/categories/DBCAT002744/parents?source=mesh&include_parents=2' 
-H 'Authorization: myapikey'

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

[
  {
    "drugbank_id": "DBCAT000499",
    "name": "Erythromycin",
    "mesh_id": "D004917",
    "mesh_tree_numbers": [
      "D02.540.576.500.992"
    ],
    "atc_code": "S01AA17",
    "atc_level": 5,
    "categorization_kinds": [
      "indexing"
    ],
    "synonyms": [
      "C, Erythromycin",
      "Erycette",
      "..."
    ],
    "description": "A bacteriostatic antibiotic macrolide produced by Streptomyces erythreus...",
    "parents": [
      {
        "drugbank_id": "DBCAT000496",
        "name": "Macrolides",
        "mesh_id": "D018942",
        "mesh_tree_numbers": [
          "D02.540.505",
          "D02.540.576.500",
          "..."
        ],
        "atc_code": "J01FA",
        "atc_level": 4,
        "synonyms": [
          "Antibiotic, Macrolide",
          "Macrolide Antibiotics",
          "..."
        ],
        "description": "A group of often glycosylated macrocyclic compounds formed by chain extension of multiple PROPIONATES cyclized into a large (typically 12, 14, or 16)-m...",
        "parents": [
          {
            "drugbank_id": "DBCAT000498",
            "name": "Lactones",
            "mesh_id": "D007783",
            "mesh_tree_numbers": [
              "D02.540"
            ],
            "atc_code": null,
            "atc_level": null,
            "synonyms": [],
            "description": "Cyclic esters of hydroxy carboxylic acids, containing a 1-oxacycloalkan-2-one structure. Large cyclic lactones of over a dozen atoms are MACROLIDES."
          },
          {
            "drugbank_id": "DBCAT000497",
            "name": "Polyketides",
            "mesh_id": "D061065",
            "mesh_tree_numbers": [
              "D02.540.576",
              "D04.345.674"
            ],
            "atc_code": null,
            "atc_level": null,
            "synonyms": [
              "Ketides"
            ],
            "description": "Natural compounds containing alternating carbonyl and methylene groups (beta-polyketones), bioenergenetically derived from repeated condensation of ace..."
          }
        ]
      }
    ]
  }
]

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.drugbank.com/v1/categories/<ID>/parents

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

GET https://api.drugbank.com/v1/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.drugbank.com/v1/categories/DBCAT000522/children' 
-H 'Authorization: myapikey'

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

[
  {
    "drugbank_id": "DBCAT000944",
    "name": "Anthelmintics",
    "mesh_id": "D000871",
    "mesh_tree_numbers": [
      "D27.505.954.122.250.075"
    ],
    "atc_code": "P02",
    "atc_level": 2,
    "categorization_kinds": [
      "therapeutic",
      "pharmacological",
      "..."
    ],
    "synonyms": [
      "Antihelmintics",
      "Vermifuges"
    ],
    "description": "Agents destructive to parasitic worms. They are used therapeutically in the treatment of HELMINTHIASIS in man and animal."
  },
  {
    "drugbank_id": "DBCAT002211",
    "name": "Antiprotozoal Agents",
    "mesh_id": "D000981",
    "mesh_tree_numbers": [
      "D27.505.954.122.250.100"
    ],
    "atc_code": "P01",
    "atc_level": 2,
    "categorization_kinds": [
      "therapeutic",
      "pharmacological",
      "..."
    ],
    "synonyms": [
      "Agents Against Protozoal Diseases",
      "Agents, Antiprotozoal",
      "..."
    ],
    "description": "Substances that are destructive to protozoans."
  }
]

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.drugbank.com/v1/categories/<ID>/children

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

GET https://api.drugbank.com/v1/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.drugbank.com/v1/categories/DBCAT001220/drugs' 
-H 'Authorization: myapikey'

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

[
  {
    "drugbank_id": "DB01303",
    "name": "Oxtriphylline",
    "cas_number": "4499-40-5",
    "annotation_status": "complete",
    "availability_by_region": [
      {
        "region": "at",
        "max_phase": 0,
        "marketed_prescription": false,
        "generic_available": false,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      {
        "region": "ca",
        "max_phase": 4,
        "marketed_prescription": true,
        "generic_available": true,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      "..."
    ],
    "description": "Oxtriphylline is the choline salt form of [theophylline]...",
    "simple_description": "A medication used to treat conditions in the lungs causing difficulty breathing, such as asthma and inflammation.",
    "clinical_description": "A bronchodilator used for the treatment of asthma, bronchitis, COPD, and emphysema.",
    "synonyms": [
      "Choline theophyllinate",
      "Choline theophylline",
      "..."
    ],
    "pharmacology": {
      "indication_description": "Used to treat the symptoms of asthma, bronchitis, COPD, and emphysema.",
      "pharmacodynamic_description": "Oxtriphylline is a bronchodilator...",
      "mechanism_of_action_description": "Oxtriphylline is a choline salt of theophylline...",
      "absorption": "After ingestion, theophylline is released from oxytriphylline in the acidic environment of the stomach. ",
      "protein_binding": "With a serum concentrations of 17 mcg/mL, adults and children have about 56% theophylline bound to plasma protein, and premature infants have about 36%...",
      "volume_of_distribution": [
        "Theophylline has an apparent volume of distribution of 0..."
      ],
      "clearance": [
        "Theophylline has an average clearance in children (over 6 months) of 1.45 mL/kg per minute, and in healthy, nonsmoking adults of 0.65 mL/kg per hour."
      ],
      "half_life": "The serum half life varies greatly between patients and in age...",
      "route_of_elimination": "The kidneys are the main route of elimination for both theophylline and its metabolites, but some unchanged theophylline is eliminated in the feces.",
      "toxicity_description": "Symptoms of toxicity include abdominal pain (continuing or severe), confusion or change in behavior, convulsions (seizures), dark or bloody vomit, diar..."
    },
    "food_interactions": [
      "Limit caffeine intake.",
      "Take with food. Food reduces irritation."
    ],
    "identifiers": {
      "drugbank_id": "DB01303",
      "inchi": "InChI=1S/C7H8N4O2.C5H14NO/c1-10-5-4(8-3-9-5)6(12)11(2)7(10)13;1-6(2,3)4-5-7/h3H,1-2H3,(H,8,9,12);7H,4-5H2,1-3H3/q;+1/p-1",
      "inchikey": "RLANKEDHRWMNRO-UHFFFAOYSA-M",
      "atc_codes": [
        {
          "code": "R03DA20",
          "title": "combinations of xanthines",
          "combination": true
        },
        {
          "code": "R03DB02",
          "title": "choline theophyllinate and adrenergics",
          "combination": true
        },
        "..."
      ]
    },
    "therapeutic_categories": [
      {
        "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..."
      },
      {
        "drugbank_id": "DBCAT000555",
        "name": "Bronchodilator Agents",
        "mesh_id": "D001993",
        "mesh_tree_numbers": [
          "D27.505.696.663.050.110",
          "D27.505.954.796.050.100"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Agents, Bronchial-Dilating",
          "Agents, Bronchodilator",
          "..."
        ],
        "description": "Agents that cause an increase in the expansion of a bronchus or bronchial tubes."
      },
      "..."
    ]
  }
]

Returns all drugs in this category.

This endpoint supports pagination.

HTTP Requests

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

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

GET https://api.drugbank.com/v1/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.drugbank.com/v1/category_names?q=antimetabolites' 
-H 'Authorization: myapikey'

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

{
  "categories": [
    {
      "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.drugbank.com/v1/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.drugbank.com/v1/category_names?q=aantimetabolites&fuzzy=true' 
-H 'Authorization: myapikey'

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 (0, 1, or 2) in to tailor the likelihood of a match (for example, fuzzy=1 will allow 1 misspelled letter).

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.drugbank.com/v1/adverse_effects?q=cardiac' 
-H 'Authorization: myapikey'

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/194757006",
      "icd10_id": "c/I10"
    },
    "patient_characteristics": [
      {
        "name": "Heart Transplant",
        "drugbank_id": "DBCOND0037477",
        "meddra_id": "llt/10007611",
        "snomed_id": "c/32413006",
        "icd10_id": "c/Z94.1"
      }
    ]
  }
]

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

HTTP Request

GET https://api.drugbank.com/v1/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.drugbank.com/v1/adverse_effects/DBCOND0020133/drugs' 
-H 'Authorization: myapikey'

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

[
  {
    "drugbank_id": "DB08911",
    "name": "Trametinib",
    "cas_number": "871700-17-3",
    "annotation_status": "complete",
    "availability_by_region": [
      {
        "region": "at",
        "max_phase": 0,
        "marketed_prescription": false,
        "generic_available": false,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      {
        "region": "ca",
        "max_phase": 4,
        "marketed_prescription": true,
        "generic_available": false,
        "pre_market_cancelled": false,
        "post_market_cancelled": false
      },
      "..."
    ],
    "description": "Trametinib dimethyl sulfoxide is a kinase inhibitor...",
    "simple_description": "A chemotherapy drug used to treat specific types of skin cancer, lung cancer, and thyroid cancer.",
    "clinical_description": "A kinase inhibitor used to treat patients with specific types of melanoma, non-small cell lung cancer, and thyroid cancer.",
    "synonyms": [
      "Tramétinib",
      "Trametinib",
      "..."
    ],
    "pharmacology": {
      "indication_description": "Trametinib is indicated as a single agent for the treatment of BRAF-inhibitor treatment-naïve patients with unresectable or metastatic melanoma with BR...",
      "pharmacodynamic_description": "Trametinib is an anticancer agent which causes apoptosis (or programmed cell death) and inhibits cell proliferation, which are both important in the tr...",
      "mechanism_of_action_description": "Trametinib is a reversible, allosteric inhibitor of mitogen-activated extracellular signal regulated kinase 1 _(MEK1)_ and _MEK2_ activation and of_ ME...",
      "absorption": "Trametinib is readily absorbed...",
      "protein_binding": "97.4% bound to human plasma proteins [FDA label]",
      "volume_of_distribution": [
        "Apparent volume of distribution (Vd/F) = 214 L [FDA label]"
      ],
      "clearance": [
        "Apparent clearance = 4.9 L/h [FDA label]"
      ],
      "half_life": "Elimination half-life = 3.9-4.8 days [FDA label].",
      "route_of_elimination": "80% of the dose is excreted in the feces...",
      "toxicity_description": "Most common adverse reactions (≥20%) for trametinib include rash, diarrhea, and lymphedema [FDA label]..."
    },
    "food_interactions": [
      "Take separate from meals. Take at least one hour before or two hours after a meal."
    ],
    "identifiers": {
      "drugbank_id": "DB08911",
      "inchi": "InChI=1S/C26H23FIN5O4/c1-13-22-21(23(31(3)24(13)35)30-20-10-7-15(28)11-19(20)27)25(36)33(17-8-9-17)26(37)32(22)18-6-4-5-16(12-18)29-14(2)34/h4-7,10-12,...",
      "inchikey": "LIRYPHYGHXZJBZ-UHFFFAOYSA-N",
      "atc_codes": [
        {
          "code": "L01XE25",
          "title": "trametinib",
          "combination": false
        }
      ]
    },
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000024",
        "name": "Antineoplastic Agents",
        "mesh_id": "D000970",
        "mesh_tree_numbers": [
          "D27.505.954.248"
        ],
        "atc_code": "L01",
        "atc_level": 2,
        "synonyms": [
          "Agents, Anticancer",
          "Agents, Antineoplastic",
          "..."
        ],
        "description": "Substances that inhibit or prevent the proliferation of NEOPLASMS."
      },
      {
        "drugbank_id": "DBCAT000003",
        "name": "Enzyme Inhibitors",
        "mesh_id": "D004791",
        "mesh_tree_numbers": [
          "D27.505.519.389"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [
          "Inhibitors, Enzyme"
        ],
        "description": "Compounds or agents that combine with an enzyme in such a manner as to prevent the normal substrate-enzyme combination and the catalytic reaction."
      },
      "..."
    ]
  }
]

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

HTTP Request

GET https://api.drugbank.com/v1/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.drugbank.com/v1/adverse_effects/DBCOND0020133/products' 
-H 'Authorization: myapikey'

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

[
  {
    "ndc_product_code": "00338-9572",
    "originator_ndc_product_code": "0338-9572",
    "dpd_id": null,
    "ema_product_code": null,
    "ema_ma_number": null,
    "pzn": null,
    "co_product_id": null,
    "tr_product_id": null,
    "it_product_id": null,
    "my_product_id": null,
    "at_product_id": null,
    "idn_product_id": null,
    "th_product_id": null,
    "sg_product_id": null,
    "name": "Bivalirudin in 0.9% Sodium Chloride",
    "prescribable_name": "Bivalirudin 25 mg /5mL Injection",
    "rx_norm_prescribable_name": "bivalirudin 250 MG in 50 ML Injection",
    "started_marketing_on": "2017-12-21",
    "ended_marketing_on": null,
    "approved_on": null,
    "schedule": null,
    "dosage_form": "Injection",
    "route": "Intravenous",
    "application_number": "NDA208374",
    "generic": false,
    "otc": false,
    "approved": true,
    "country": "US",
    "mixture": false,
    "allergenic": false,
    "cosmetic": false,
    "vaccine": false,
    "ingredients": [
      {
        "name": "Bivalirudin",
        "drugbank_id": "DB00006",
        "strength": {
          "number": "250",
          "unit": "mg/50mL"
        }
      }
    ],
    "therapeutic_categories": [
      {
        "drugbank_id": "DBCAT000021",
        "name": "Amino Acids, Peptides, and Proteins",
        "mesh_id": "D000602",
        "mesh_tree_numbers": [
          "D12"
        ],
        "atc_code": null,
        "atc_level": null,
        "synonyms": [],
        "description": "Amino acids and chains of amino acids connected by peptide linkages."
      },
      {
        "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."
      },
      "..."
    ],
    "labeller": {
      "name": "Baxter Healthcare Corporation"
    },
    "images": []
  }
]

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

HTTP Request

GET https://api.drugbank.com/v1/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.
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.

Boxed Warnings

Search boxed warning

curl -L 'https://api.drugbank.com/v1/boxed_warnings?q=cardiac' 
-H 'Authorization: myapikey'

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

[
  {
    "drug": {
      "name": "Estetrol",
      "drugbank_id": "DB12235"
    },
    "kind": "warning",
    "administration": "Do not administer to females over 35 who smoke.",
    "lab_values": [],
    "route": [],
    "dose_form": [],
    "sex_group": "female",
    "above_age": {
      "amount": 36,
      "unit": "year"
    },
    "risk": {
      "name": "Cardiovascular Events",
      "drugbank_id": "DBCOND0048671",
      "snomed_id": "d/2157405016",
      "icd10_id": "c/I24.9"
    },
    "patient_characteristics": [
      {
        "name": "Smokers",
        "drugbank_id": "DBCOND0034591",
        "meddra_id": "llt/10048880",
        "snomed_id": "c/160622001"
      }
    ],
    "with_drugs": [
      {
        "name": "Drospirenone",
        "drugbank_id": "DB01395"
      }
    ]
  }
]

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

HTTP Request

GET https://api.drugbank.com/v1/boxed_warnings

Query Parameters

Parameter	Default	Description
q	“”	Text used to search conditions by name.
exact	false	Determines how text results are matched. exact=true will not include partial matches such as ‘Rheumatoid Arthritis’ for the query 'arthritis’.

Packages

Get a specific U.S. package

curl -L 'https://api.drugbank.com/v1/packages/50580-111-08' 
-H 'Authorization: myapikey'

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

{
  "package_ndc_code": "50580-0111-08",
  "originator_package_ndc_code": "50580-111-08",
  "description": "240 mL LIQUID IN 1 BOTTLE, PLASTIC",
  "full_description": "240 mL LIQUID IN 1 BOTTLE, PLASTIC",
  "amount": "240",
  "unit": "mL",
  "form": "BOTTLE, PLASTIC",
  "for_product": {
    "ndc_product_code": "50580-0111",
    "originator_ndc_product_code": "50580-111",
    "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",
      "originator_package_ndc_code": "50580-111-08",
      "description": "240 mL LIQUID 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 Local Product ID.

HTTP Request

GET https://api.drugbank.com/v1/packages/<LOCAL_PRODUCT_ID>

URL Parameters

Parameter	Description
LOCAL_PRODUCT_ID	The Local Product ID of the package to retrieve.

Get the most current FDA label for a package

curl -L 'https://api.drugbank.com/v1/packages/50580-111-08/label' 
-H 'Authorization: myapikey'

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

{
  "id": "5a42290a-810c-427c-a406-2df70a02c372",
  "set_id": "81f3847f-99e8-4ff3-ad18-f8b8e1c54238",
  "version": 1,
  "current": true,
  "title": "Tylenol Extra Strength - Acetaminophen LIQUID",
  "product_type": "HUMAN OTC DRUG LABEL",
  "effective_on": "2012-12-10",
  "labeler_name": "McNeil Consumer Healthcare Div. McNeil-PPC, Inc",
  "drugbank_status": "processed",
  "first_product_marketing_started_on": "1998-04-01",
  "last_product_marketing_ended_on": "2012-10-31",
  "pmg_section_count": 6,
  "hpi_section_count": 9,
  "sli_section_count": 2,
  "all_section_count": 17,
  "abuse": null,
  "accessories": null,
  "active_ingredient": "<section id=\"section-2\" class=\"content-section\" data-section-code=\"55106-9\"><h1>Active ingredient (in each 15 mL = 1 tablespoon)</h1>\n<div class=\"conte...",
  "adverse_reactions": null,
  "alarms": null,
  "animal_pharmacology_and_or_toxicology": null,
  "ask_doctor": "<section id=\"section-5...",
  "ask_doctor_or_pharmacist": "<section id=\"section-5...",
  "assembly_or_installation_instructions": null,
  "boxed_warning": null,
  "calibration_instructions": null,
  "carcinogenesis_and_mutagenesis_and_impairment_of_fertility": null,
  "cleaning": null,
  "clinical_pharmacology": null,
  "clinical_studies": null,
  "compatible_accessories": null,
  "components": null,
  "contraindications": null,
  "controlled_substance": null,
  "dependence": null,
  "description": null,
  "diagram_of_device": null,
  "disposal_and_waste_handling": null,
  "do_not_use": "<section id=\"section-5...",
  "dosage_and_administration": "<section id=\"section-6\" class=\"content-section\" data-section-code=\"34068-7\"><h1>Directions</h1>\n<div class=\"content-section-inner\" id=\"\">\n<ul class=\"sq...",
  "dosage_forms_and_strengths": null,
  "drug_abuse_and_dependence": null,
  "drug_interactions": null,
  "drug_and_or_laboratory_test_interactions": null,
  "environmental_warning": null,
  "food_safety_warning": null,
  "general_precautions": null,
  "geriatric_use": null,
  "guaranteed_analysis_of_feed": null,
  "health_care_provider_letter": null,
  "health_claim": null,
  "how_supplied": null,
  "inactive_ingredient": "<section id=\"section-8\" class=\"content-section\" data-section-code=\"51727-6\"><h1>Inactive ingredients</h1>\n<div class=\"content-section-inner\" id=\"\"><p>a...",
  "indications_and_usage": "<section id=\"section-4\" class=\"content-section\" data-section-code=\"34067-9\"><h1>Uses</h1>\n<div class=\"content-section-inner\" id=\"\"><ul class=\"square\">\n...",
  "information_for_owners_or_caregivers": null,
  "information_for_patients": null,
  "instructions_for_use": null,
  "intended_use_of_the_device": null,
  "keep_out_of_reach_of_children": "<section id=\"section-5...",
  "labor_and_delivery": null,
  "laboratory_tests": null,
  "mechanism_of_action": null,
  "microbiology": null,
  "nonclinical_toxicology": null,
  "nonteratogenic_effects": null,
  "nursing_mothers": null,
  "other_safety_information": null,
  "overdosage": null,
  "package_label_principal_display_panel": "<section id=\"section-10\" class=\"content-section\" data-section-code=\"51945-4\"><h1>PRINCIPAL DISPLAY PANEL</h1>\n<div class=\"content-section-inner\" id=\"\">...",
  "patient_medication_information": null,
  "pediatric_use": null,
  "pharmacodynamics": null,
  "pharmacogenomics": null,
  "pharmacokinetics": null,
  "precautions": null,
  "pregnancy": null,
  "pregnancy_or_breast_feeding": "<section id=\"section-5...",
  "purpose": "<section id=\"section-3\" class=\"content-section\" data-section-code=\"55105-1\"><h1>Purpose</h1>\n<div class=\"content-section-inner\" id=\"\"><p>Pain reliever/...",
  "questions": "<section id=\"section-9\" class=\"content-section\" data-section-code=\"53413-1\"><h1>Questions or comments?</h1>\n<div class=\"content-section-inner\" id=\"\"><p...",
  "recent_major_changes": null,
  "references": null,
  "residue_warning": null,
  "risks": null,
  "route": null,
  "safe_handling_warning": null,
  "spl_indexing_data_elements": null,
  "spl_medguide": null,
  "spl_patient_package_insert": null,
  "spl_product_data_elements": null,
  "spl_unclassified": "<section id=\"section-1\" class=\"content-section\" data-section-code=\"42229-5\"><div class=\"content-section-inner\" id=\"\"><p><span class=\"bold italics\">Drug...",
  "statement_of_identity": null,
  "stop_use": "<section id=\"section-5...",
  "storage_and_handling": "<section id=\"section-7\" class=\"content-section\" data-section-code=\"44425-7\"><h1>Other information</h1>\n<div class=\"content-section-inner\" id=\"\"><ul cla...",
  "summary_of_safety_and_effectiveness": null,
  "teratogenic_effects": null,
  "troubleshooting": null,
  "use_in_specific_populations": null,
  "user_safety_warnings": null,
  "warnings": "<section id=\"section-5\" class=\"content-section\" data-section-code=\"34071-1\"><h1>Warnings</h1>\n<div class=\"content-section-inner\" id=\"\">\n<section id=\"se...",
  "warnings_and_cautions": null,
  "when_using": null
}

This endpoint retrieves the most current FDA label for a package, based on NDC package ID.

HTTP Request

GET https://api.drugbank.com/v1/packages/<NDC_PACKAGE_ID>/label

Query Parameters

Parameter	Default	Description
content_format	html	Format to return for section content from label, either html (default) or text.

Labels

Get a specific label

curl -L 'https://api.drugbank.com/v1/us/labels/77c79fcb-5b96-4a4f-8ce9-1603d39cb037' 
-H 'Authorization: myapikey'

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

{
  "id": "77c79fcb-5b96-4a4f-8ce9-1603d39cb037",
  "set_id": "51abd2ce-6be1-412d-b806-5f24935ac5e3",
  "version": 17,
  "current": false,
  "title": "Zidovudine - Zidovudine SYRUP",
  "product_type": "HUMAN PRESCRIPTION DRUG LABEL",
  "effective_on": "2019-09-19",
  "labeler_name": "Aurobindo Pharma Limited",
  "drugbank_status": "archived",
  "first_product_marketing_started_on": "2005-09-19",
  "last_product_marketing_ended_on": null,
  "pmg_section_count": 1,
  "hpi_section_count": 18,
  "sli_section_count": 8,
  "all_section_count": 27,
  "abuse": null,
  "accessories": null,
  "active_ingredient": null,
  "adverse_reactions": "<section id=\"section-6\" class=\"content-section\" data-section-code=\"34084-4\"><h1>6 ADVERSE REACTIONS</h1>\n<div class=\"content-section-inner\" id=\"Section...",
  "alarms": null,
  "animal_pharmacology_and_or_toxicology": null,
  "ask_doctor": null,
  "ask_doctor_or_pharmacist": null,
  "assembly_or_installation_instructions": null,
  "boxed_warning": "<section id=\"boxed-warning\" data-section-code=\"34066-1\" class=\"content-section\"><h1>Boxed Warning</h1>\n<div class=\"boxed-warning-section\">\n<h2>WARNING:...",
  "calibration_instructions": null,
  "carcinogenesis_and_mutagenesis_and_impairment_of_fertility": "<section id=\"section-12...",
  "cleaning": null,
  "clinical_pharmacology": "<section id=\"section-11\" class=\"content-section\" data-section-code=\"34090-1\"><h1>12 CLINICAL PHARMACOLOGY</h1>\n<div class=\"content-section-inner\" id=\"S...",
  "clinical_studies": "<section id=\"section-13\" class=\"content-section\" data-section-code=\"34092-7\"><h1>14 CLINICAL STUDIES</h1>\n<div class=\"content-section-inner\" id=\"Sectio...",
  "compatible_accessories": null,
  "components": null,
  "contraindications": "<section id=\"section-4\" class=\"content-section\" data-section-code=\"34070-3\"><h1>4 CONTRAINDICATIONS</h1>\n<div class=\"content-section-inner\" id=\"Section...",
  "controlled_substance": null,
  "dependence": null,
  "description": "<section id=\"section-10\" class=\"content-section\" data-section-code=\"34089-3\"><h1>11 DESCRIPTION</h1>\n<div class=\"content-section-inner\" id=\"Section_11\"...",
  "diagram_of_device": null,
  "disposal_and_waste_handling": null,
  "do_not_use": null,
  "dosage_and_administration": "<section id=\"section-2\" class=\"content-section\" data-section-code=\"34068-7\"><h1>2 DOSAGE AND ADMINISTRATION</h1>\n<div class=\"content-section-inner\" id=...",
  "dosage_forms_and_strengths": "<section id=\"section-3\" class=\"content-section\" data-section-code=\"43678-2\"><h1>3 DOSAGE FORMS AND STRENGTHS</h1>\n<div class=\"content-section-inner\" id...",
  "drug_abuse_and_dependence": null,
  "drug_interactions": "<section id=\"section-7\" class=\"content-section\" data-section-code=\"34073-7\"><h1>7 DRUG INTERACTIONS</h1>\n<div class=\"content-section-inner\" id=\"Section...",
  "drug_and_or_laboratory_test_interactions": null,
  "environmental_warning": null,
  "food_safety_warning": null,
  "general_precautions": null,
  "geriatric_use": "<section id=\"section-8...",
  "guaranteed_analysis_of_feed": null,
  "health_care_provider_letter": null,
  "health_claim": null,
  "how_supplied": "<section id=\"section-14\" class=\"content-section\" data-section-code=\"34069-5\"><h1>16 HOW SUPPLIED/STORAGE AND HANDLING</h1>\n<div class=\"content-section-...",
  "inactive_ingredient": null,
  "indications_and_usage": "<section id=\"section-1\" class=\"content-section\" data-section-code=\"34067-9\"><h1>1 INDICATIONS AND USAGE</h1>\n<div class=\"content-section-inner\" id=\"Sec...",
  "information_for_owners_or_caregivers": null,
  "information_for_patients": "<section id=\"section-15\" class=\"content-section\" data-section-code=\"34076-0\"><h1>17 PATIENT COUNSELING INFORMATION</h1>\n<div class=\"content-section-inn...",
  "instructions_for_use": null,
  "intended_use_of_the_device": null,
  "keep_out_of_reach_of_children": null,
  "labor_and_delivery": "<section id=\"section-8...",
  "laboratory_tests": null,
  "mechanism_of_action": "<section id=\"section-11...",
  "microbiology": null,
  "nonclinical_toxicology": "<section id=\"section-12\" class=\"content-section\" data-section-code=\"43680-8\"><h1>13 NONCLINICAL TOXICOLOGY</h1>\n<div class=\"content-section-inner\" id=\"...",
  "nonteratogenic_effects": null,
  "nursing_mothers": null,
  "other_safety_information": null,
  "overdosage": "<section id=\"section-9\" class=\"content-section\" data-section-code=\"34088-5\"><h1>10 OVERDOSAGE</h1>\n<div class=\"content-section-inner\" id=\"Section_10\">\n...",
  "package_label_principal_display_panel": "<section id=\"section-16\" class=\"content-section\" data-section-code=\"51945-4\"><h1>PACKAGE LABEL-PRINCIPAL DISPLAY PANEL - 10 mg/mL (240 mL Bottle)</h1>\n...",
  "patient_medication_information": null,
  "pediatric_use": "<section id=\"section-8...",
  "pharmacodynamics": null,
  "pharmacogenomics": null,
  "pharmacokinetics": "<section id=\"section-11...",
  "precautions": null,
  "pregnancy": "<section id=\"section-8...",
  "pregnancy_or_breast_feeding": null,
  "purpose": null,
  "questions": null,
  "recent_major_changes": null,
  "references": null,
  "residue_warning": null,
  "risks": null,
  "route": null,
  "safe_handling_warning": null,
  "spl_indexing_data_elements": null,
  "spl_medguide": null,
  "spl_patient_package_insert": null,
  "spl_product_data_elements": null,
  "spl_unclassified": "<section id=\"section-1...",
  "statement_of_identity": null,
  "stop_use": null,
  "storage_and_handling": null,
  "summary_of_safety_and_effectiveness": null,
  "teratogenic_effects": null,
  "troubleshooting": null,
  "use_in_specific_populations": "<section id=\"section-8\" class=\"content-section\" data-section-code=\"43684-0\"><h1>8 USE IN SPECIFIC POPULATIONS</h1>\n<div class=\"content-section-inner\" i...",
  "user_safety_warnings": null,
  "warnings": null,
  "warnings_and_cautions": "<section id=\"section-5\" class=\"content-section\" data-section-code=\"43685-7\"><h1>5 WARNINGS AND PRECAUTIONS</h1>\n<div class=\"content-section-inner\" id=\"...",
  "when_using": null
}

This endpoint retrieves a specific FDA label (SPL) based on SPL document ID or the SPL set ID.

HTTP Request

GET https://api.drugbank.com/v1/us/labels/<DOCUMENT_ID>

URL Parameters

Parameter	Description
ID	The SPL document ID or set ID of the label to retrieve.

Query Parameters

Parameter	Default	Description
content_format	html	Format to return for section content from label, either html (default) or text.

Label sections

The label sections are returned by default as html. The sections contain structured information such as headings, tables, and images. However, you can optionally return the content as text using the content_format parameter.

The html that is returned contains a wrapping <section> tag, with a unique ID that is used to link to that section within the other sections.

Images within the sections are linked to DrugBank assets. The tags within sections are easily styled, and you can generate a styled label. See the example label here.

The content of a label is broken down into unique, categorized sections (listed in the tables below). Different sections are relevant for each of the labels modules: hpi (Health Profesional Information), pmg (Patient Medication Guides), or sli (Supplementary Label Information). Total section counts for each module as well as the entire label can be found in the API response (note that the same section can appear in more than one module).

Abuse and overdosage

Section	Description
drug_abuse_and_dependence	Information about whether the drug is a controlled substance, the types of abuse that can occur with the drug, and adverse reactions pertinent to those types of abuse.
abuse	Information about the types of abuse that can occur with the drug and adverse reactions pertinent to those types of abuse, primarily based on human data. May include descriptions of particularly susceptible patient populations.
controlled_substance	Information about the schedule in which the drug is controlled by the Drug Enforcement Administration, if applicable.
dependence	Information about characteristic effects resulting from both psychological and physical dependence that occur with the drug, the quantity of drug over a period of time that may lead to tolerance or dependence, details of adverse effects related to chronic abuse and the effects of abrupt withdrawl, procedures necessary to diagnose the dependent state, and principles of treating the effects of abrupt withdrawal.
overdosage	Information about signs, symptoms, and laboratory findings of acute ovedosage and the general principles of overdose treatment.

Adverse effects and interactions

Section	Description
adverse_reactions	Information about undesirable effects, reasonably associated with use of the drug, that may occur as part of the pharmacological action of the drug or may be unpredictable in its occurrence. Adverse reactions include those that occur with the drug, and if applicable, with drugs in the same pharmacologically active and chemically related class. There is considerable variation in the listing of adverse reactions. They may be categorized by organ system, by severity of reaction, by frequency, by toxicological mechanism, or by a combination of these.
drug_interactions	Information about and practical guidance on preventing clinically significant drug/drug and drug/food interactions that may occur in people taking the drug.
drug_and_or_laboratory_test_ interactions	Information about any known interference by the drug with laboratory tests.

Clinical pharmacology

Section	Description
clinical_pharmacology	Information about the clinical pharmacology and actions of the drug in humans.
mechanism_of_action	Information about the established mechanism(s) of the drug’s action in humans at various levels (for example receptor, membrane, tissue, organ, whole body). If the mechanism of action is not known, this field contains a statement about the lack of information.
pharmacodynamics	Information about any biochemical or physiologic pharmacologic effects of the drug or active metabolites related to the drug’s clinical effect in preventing, diagnosing, mitigating, curing, or treating disease, or those related to adverse effects or toxicity.
pharmacokinetics	Information about the clinically significant pharmacokinetics of a drug or active metabolites, for instance pertinent absorption, distribution, metabolism, and excretion parameters.

Indications, usage, and dosage

Section	Description
indications_and_usage	A statement of each of the drug product’s indications for use, such as for the treatment, prevention, mitigation, cure, or diagnosis of a disease or condition, or of a manifestation of a recognized disease or condition, or for the relief of symptoms associated with a recognized disease or condition. This field may also describe any relevant limitations of use.
contraindications	Information about situations in which the drug product is contraindicated or should not be used because the risk of use clearly outweighs any possible benefit, including the type and nature of reactions that have been reported.
dosage_and_administration	Information about the drug product’s dosage and administration recommendations, including starting dose, dose range, titration regimens, and any other clinically sigificant information that affects dosing recommendations.
dosage_forms_and_strengths	Information about all available dosage forms and strengths for the drug product to which the labeling applies. This field may contain descriptions of product appearance.
purpose	Information about the drug product’s indications for use.
description	General information about the drug product, including the proprietary and established name of the drug, the type of dosage form and route of administration to which the label applies, qualitative and quantitative ingredient information, the pharmacologic or therapeutic class of the drug, and the chemical name and structural formula of the drug.
active_ingredient	A list of the active, medicinal ingredients in the drug product.
inactive_ingredient	A list of inactive, non-medicinal ingredients in a drug product.
spl_product_data_elements	Typically a list of ingredients in a drug product.

Patient information

Section	Description
spl_patient_package_insert	Information necessary for patients to use the drug safely and effectively.
information_for_patients	Information necessary for patients to use the drug safely and effectively, such as precautions concerning driving or the concomitant use of other substances that may have harmful additive effects.
information_for_owners_or_caregivers	Information to be supplied to a guardian/caregiver overseeing the use of the drug product.
instructions_for_use	Information about safe handling and use of the drug product.
ask_doctor	Information about when a doctor should be consulted about existing conditions or sumptoms before using the drug product, including all warnings for persons with certain preexisting conditions (excluding pregnancy) and all warnings for persons experiencing certain symptoms. The warnings under this heading are those intended only for situations in which consumers should not use the product until a doctor is consulted.
ask_doctor_or_pharmacist	Information about when a doctor or pharmacist should be consulted about drug/drug or drug/food interactions before using a drug product.
do_not_use	Information about all contraindications for use. These contraindications are absolute and are intended for situations in which consumers should not use the product unless a prior diagnosis has been established by a doctor or for situations in which certain consumers should not use the product under any circumstances regardless of whether a doctor or health professional is consulted.
keep_out_of_reach_of_children	Information pertaining to whether the product should be kept out of the reach of children, and instructions about what to do in the case of accidental contact or ingestion, if appropriate.
other_safety_information	Information about safe use and handling of the product that may not have been specified in another field.
questions	A telephone number of a source to answer questions about a drug product. Sometimes available days and times are also noted.
stop_use	Information about when use of the drug product should be discontinued immediately and a doctor consulted. Includes information about any signs of toxicity or other reactions that would necessitate immediately discontinuing use of the product.
when_using	Information about side effects that people may experience, and the substances (e.g. alcohol) or activities (e.g. operating machinery, driving a car) to avoid while using the drug product.
patient_medication_information	Information or instructions to patients about safe use of the drug product, sometimes including a reference to a patient medication guide or counseling materials.
spl_medguide	Information about the patient medication guide that accompanies the drug product. Certain drugs must be dispensed with an accompanying medication guide. This field may contain information about when to consult the medication guide and the contents of the medication guide.

Special populations

Section	Description
use_in_specific_populations	Information about use of the drug by patients in specific populations, including pregnant women and nursing mothers, pediatric patients, and geriatric patients.
pregnancy	Information about effects the drug may have on pregnant women or on a fetus. This field may be ommitted if the drug is not absorbed systemically and the drug is not known to have a potential for indirect harm to the fetus. It may contain information about the established pregnancy category classification for the drug (that information is nominally listed in the teratogenic_effects field, but may be listed here instead).
teratogenic_effects	Pregnancy category A: Adequate and well-controlled studies in pregnant women have failed to demonstrate a risk to the fetus in the first trimester of pregnancy, and there is no evidence of a risk in later trimesters. Pregnancy category B: Animal reproduction studies have failed to demonstrate a risk to the fetus and there are no adequate and well-controlled studies in pregnant women. Pregnancy category C: Animal reproduction studies have shown an adverse effect on the fetus, there are no adequate and well-controlled studies in humans, and the benefits from the use of the drug in pregnant women may be acceptable despite its potential risks. Pregnancy category D: There is positive evidence of human fetal risk based on adverse reaction data from investigational or marketing experience or studies in humans, but the potential benefits from the use of the drug in pregnant women may be acceptable despite its potential risks (for example, if the drug is needed in a life-threatening situation or serious disease for which safer drugs cannot be used or are ineffective). Pregnancy category X: Studies in animals or humans have demonstrated fetal abnormalities or there is positive evidence of fetal risk based on adverse reaction reports from investigational or marketing experience, or both, and the risk of the use of the drug in a pregnant woman clearly outweighs any possible benefit (for example, safer drugs or other forms of therapy are available).
labor_and_delivery	Information about the drug’s use during labor or delivery, whether or not the use is stated in the indications section of the labeling, including the effect of the drug on the mother and fetus, on the duration of labor or delivery, on the possibility of delivery-related interventions, and the effect of the drug on the later growth, development, and functional maturation of the child.
nursing_mothers	Information about excretion of the drug in human milk and effects on the nursing infant, including pertinent adverse effects observed in animal offspring.
pregnancy_or_breast_feeding	Details about usage of the product while pregnant or breast feeding.
pediatric_use	Information about any limitations on any pediatric indications, needs for specific monitoring, hazards associated with use of the drug in any subsets of the pediatric population (such as neonates, infants, children, or adolescents), differences between pediatric and adult responses to the drug, and other information related to the safe and effective pediatric use of the drug.
geriatric_use	Information about any limitations on any geriatric indications, needs for specific monitoring, hazards associated with use of the drug in the geriatric population.

Nonclinical toxicology

Section	Description
nonclinical_toxicology	Information about toxicology in non-human subjects.
nonteratogenic_effects	Details about potential neonatal complications when used by a pregnant mother.
carcinogenesis_and_mutagenesis_ and_impairment_of_fertility	Information about carcinogenic, mutagenic, or fertility impairment potential revealed by studies in animals. Information from human data about such potential is part of the warnings field.
animal_pharmacology_and_ or_toxicology	Information from studies of the drug in animals, if the data were not relevant to nor included in other parts of the labeling. Most labels do not contain this field.

References

Section	Description
clinical_studies	This field may contain references to clinical studies in place of detailed discussion in other sections of the labeling.
references	May contain references when prescription drug labeling must summarize or otherwise relay on a recommendation by an authoritative scientific body, or on a standardized methodology, scale, or technique, because the information is important to prescribing decisions.

Supply, storage, and handling

Section	Description
how_supplied	Information about the available dosage forms to which the labeling applies, and for which the manufacturer or distributor is responsible. This field ordinarily includes the strength of the dosage form (in metric units), the units in which the dosage form is available for prescribing, appropriate information to facilitate identification of the dosage forms (such as shape, color, coating, scoring, and National Drug Code), and special handling and storage condition information.
storage_and_handling	Information about safe storage and handling of the drug product.
safe_handling_warning	Warning about how to safely handle the drug or device.

Warnings and precautions

Section	Description
boxed_warning	Information about contraindications or serious warnings, particularly those that may lead to death or serious injury (also known as “blackbox warnings”).
user_safety_warnings	When a drug can pose a hazard to human health by contact, inhalation, ingestion, injection, or by any exposure, this field contains information which can prevent or decrease the possibility of harm.
warnings	Information about serious adverse reactions and potential safety hazards, including limitations in use imposed by those hazards and steps that should be taken if they occur.
warnings_and_cautions	Warnings and cautions to take while using the product.
general_precautions	Information about any special care to be exercised for safe and effective use of the drug.

Other fields

In addition, there are several sections that are less well defined and are less commonly used.

Section	Description
accessories	Details about accessories that can be used with the product.
alarms	Details regarding major adverse reactions. Typically not present.
assembly_or_installation_instructions	Instructions on assembling/installing a drug product (typically applies to kits).
calibration_instructions	Instructions on calibrating a device.
cleaning	Details on how to clean a device.
compatible_accessories	Details about relevant compatible accessories/parts/products.
components	Details of the various components in a product.
diagram_of_device	A picture of the delivery device for a drug product.
disposal_and_waste_handling	Details about how to dispose of an expired or used drug product.
environmental_warning	Details about environmental risks a product may pose.
food_safety_warning	Warning about the effects of foods on the drug, and vice versa.
guaranteed_analysis_of_feed	A guarantee about the content of a single serving of a product (for animal drug labels).
health_care_provider_letter	A letter, from the manufacturer, intended for the health care provider (typically regarding shortages, etc.).
health_claim	A specific health claim being made about the drug product.
intended_use_of_the_device	Details about how the device is intended to be used.
laboratory_tests	Information on laboratory tests helpful in following the patient’s response to the drug or in identifying possible adverse reactions. If appropriate, information may be provided on such factors as the range of normal and abnormal values expected in the particular situation and the recommended frequency with which tests should be performed before, during, and after therapy.
microbiology	Details about microbiology, usually present for anti-bacterials.
package_label_principal_display_panel	The content of the principal display panel of the product package, usually including the product’s name, dosage forms, and other key information about the drug product.
pharmacogenomics	A description of the pharmacogenomics for a drug.
precautions	Information about any special care to be exercised for safe and effective use of the drug.
recent_major_changes	A list of the section(s) that contain substantive changes that have been approved by FDA in the product labeling. The headings and subheadings, if appropriate, affected by the change are listed together with each section’s identifying number and the month and year on which the change was incorporated in the labeling.
residue_warning	Warnings about residues present on the product.
risks	Details about risks when usig the product.
route	Details about the route of administration for a product.
statement_of_identity	Details about the content of a nutritional supplement.
summary_of_safety_and_effectiveness	Summarization of safety and effectiveness.
troubleshooting	Troubleshooting guide for patient instructions.
spl_indexing_data_elements	Used for indexing a label.
spl_unclassified	Information not classified as belonging to one of the other fields. Approximately 40% of labeling with effective_time between June 2009 and August 2014 have information in this field.

Get the rendered contents of a specific FDA label

curl -L 'https://api.drugbank.com/v1/us/labels/77c79fcb-5b96-4a4f-8ce9-1603d39cb037/rendered?content=full' 
-H 'Authorization: myapikey'

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

{
  "id": "77c79fcb-5b96-4a4f-8ce9-1603d39cb037",
  "set_id": "51abd2ce-6be1-412d-b806-5f24935ac5e3",
  "version": 17,
  "current": false,
  "title": "Zidovudine - Zidovudine SYRUP",
  "product_type": "HUMAN PRESCRIPTION DRUG LABEL",
  "effective_on": "2019-09-19",
  "labeler_name": "Aurobindo Pharma Limited",
  "drugbank_status": "archived",
  "first_product_marketing_started_on": "2005-09-19",
  "last_product_marketing_ended_on": null,
  "pmg_section_count": 1,
  "hpi_section_count": 18,
  "sli_section_count": 8,
  "all_section_count": 27,
  "content": "<div class=\"container-fluid\"><h1 class=\"display-1\">Zidovudine - Zidovudine SYRUP</h1><div class=\"row\" id=\"drugbank-label\"><div class=\"col\" id=\"table-of..."
}

Including label.css and rendered content in HTML:

<html>
  <head>
    <meta charset="UTF-8">
    <link rel="stylesheet" href="label.css" />
  </head>
  <body>
    <!--label content-->
  </body>
</html>

This endpoint retrieves a specific FDA label (SPL) based on SPL document ID or the SPL set ID. It returns the applicable sections of a label grouped in one HTML content field.

Images within the sections are linked to DrugBank assets. The tags within sections are easily styled, and you can generate a styled label. See the example label here.

You can style this label using your own CSS. You can download the styles used in the example above here. They will need to be linked in the HTML where you display the label.

Note that the content parameter is required and API responses will be filtered accordingly - full, hpi, pmg, or sli.

HTTP Request

GET https://api.drugbank.com/v1/us/labels/<DOCUMENT_ID>/rendered

URL Parameters

Parameter	Description
ID	The SPL document ID or set ID of the label to retrieve.

Query Parameters

Parameter	Default	Description
content		The group of sections to include in the rendered label that must be set to one of the following. full renders the entire label. hpi (Health Profesional Information), pmg (Patient Medication Guides), or sli (Supplementary Label Information) will render smaller versions of the label, serving specific purposes.

Get historic documents for a specific FDA label

curl -L 'https://api.drugbank.com/v1/us/labels/77c79fcb-5b96-4a4f-8ce9-1603d39cb037/set' 
-H 'Authorization: myapikey'

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

[
  {
    "id": "0e078fae-98fa-42bf-8093-de11b5a882b3",
    "version": 19,
    "current": true,
    "title": "Zidovudine - Zidovudine SYRUP",
    "product_type": "HUMAN PRESCRIPTION DRUG LABEL",
    "labeler_name": "Aurobindo Pharma Limited",
    "drugbank_status": "processed"
  },
  {
    "id": "ed3f2e6d-6d2b-4cc4-97cd-617455d30742",
    "version": 18,
    "current": false,
    "title": "Zidovudine - Zidovudine SYRUP",
    "product_type": "HUMAN PRESCRIPTION DRUG LABEL",
    "labeler_name": "Aurobindo Pharma Limited",
    "drugbank_status": "archived"
  },
  "..."
]

This endpoint retrieves other labels with the same set ID for a specific FDA label (SPL) based on SPL document ID. A set ID is a GUID (globally unique identifier) for the document that remains constant through all versions/revisions of the document.

HTTP Request

GET https://api.drugbank.com/v1/us/labels/<DOCUMENT_ID>/set

URL Parameters

Parameter	Description
ID	The SPL document ID or set ID of the label 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

Version	Released	Removed
v0	July, 2016	March, 2022
v1	September, 2016	Current

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

https://docs.drugbank.com

This will always direct you to the newest version of the API.

API Upgrades and Changes

Keeping track of changes and upgrades to the DrugBank API

Your API version (e.g. v1) controls the API behavior you see (e.g., what properties you see in responses, what parameters you’re permitted to send in requests, etc.). When we change the API in a backwards-incompatible way, we release a new version, but to avoid breaking your code, we maintain older versions for a reasonable period of time and support users in their migration. Older versions will not be removed without ensuring full migration for all customers, however we encourage customers to keep up to date with newer versions to take advantage of improvements and additions.

Backwards-compatible changes

DrugBank considers the following changes to be backwards-compatible:

• Adding new API resources.
• Adding new optional request parameters to existing API methods.
• Adding new properties to existing API responses.
• Changing the order of properties in existing API responses.
• Changing the length or format of opaque strings, such as error messages and other human-readable strings.
• Improving the relevance or ordering of search results

You can safely assume object IDs will not change in length, and will never exceed 255 characters.

Upgrading your API version

If you’re running an older version of the API, upgrade to the latest version to take advantage of new functionality or to streamline responses so the API is faster for you. Upgrading your API version can affect:

• The parameters you can send and the structure of objects returned.
• The parameters in headers that are required and returned.
• How request tallies are calculated for billing purposes.
• How authentication is performed.
• Whether endpoints are available. Endpoints may be deprecated with major version changes.

To upgrade to the latest version, change the version number in requests sent to the API (e.g. change “v0” to “v1”). You can also use two versions of the API at the same time to upgrade iteratively.

When performing an API upgrade, make sure that you review the change log below, and that your tests pass against the endpoints you are using in your application. You can run your tests against the new version while still using your previous version in production.

Clinical API changelog

The changelog is a list of updates in the clinical API. Minor backwards-compatible additions and improvements (e.g. increasing the performance of an endpoint) may not appear in this list.

June 24, 2022

• New Added the drug-drug interactions plugin as a “plug and play” option for our DDI endpoints.

June 15, 2022

curl -L 'https://api.drugbank.com/v1/conditions?q=arth' 
-H 'Authorization: myapikey'

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

[
  {
    "hits": [
      {
        "field": "general title",
        "value": "<em>Arth</em>ritis/<em>Arth</em>rosis"
      }
    ],
    "name": "Arthritis/Arthrosis",
    "drugbank_id": "DBCOND0086825",
    "uniprot_id": null,
    "meddra_id": null,
    "icd10_id": null,
    "snomed_id": null
  },
  {
    "hits": [
      {
        "field": "general title",
        "value": "<em>Arth</em>ritis and <em>Arth</em>ralgia"
      }
    ],
    "name": "Arthritis and Arthralgia",
    "drugbank_id": "DBCOND0142150",
    "uniprot_id": null,
    "meddra_id": null,
    "icd10_id": null,
    "snomed_id": null
  },
  "..."
]

• New Updated conditions search to facilitate autocomplete and fuzzy searching.

June 01, 2022

Search ICD-10 concepts by code or description.

curl -L 'https://api.drugbank.com/v1/icd10?q=alz' 
-H 'Authorization: myapikey'

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

[
  {
    "hits": [
      {
        "field": "description",
        "value": "<em>Alz</em>heimer's disease"
      }
    ],
    "identifier": "G30",
    "description": "Alzheimer's disease"
  }
]

• New Added an ICD-10 Search endpoint.

May 16, 2022

• New Therapeutic alternatives are now constrained to drugs that specifically have therapeutic categorizations.

April 30, 2022

• Removed “Find DDI with Product Names” is no longer supported.

April 13, 2022

• New Added stricter but more informative validation of per_page parameter.

April 06, 2022

• New Added an include_references query parameter when retrieving adverse effects for drugs, products, and product concepts.

March 31, 2022

• Removed v0 of the API is no longer supported.

March 23, 2022

• New Added the medication search plugin as a “plug and play” option for our medication name search endpoint.

March 09, 2022

• New Added drug products that have received emergency use authorization across all regions.

February 09, 2022

Partial drug alternatives for DB01060 (Amoxicillin). Full result also contains the Anti-Bacterial Agents and Penicillins categories.

[
   { 
        "drugbank_id": "DBCAT003682",
        "name": "Aminopenicillins",
        "mesh_id": null,
        "mesh_tree_numbers": [],
        "atc_code": null,
        "atc_level": null,
        "categorization_kind": "therapeutic",
        "synonyms": [],
        "description": null,
        "drugs": [
            {
                "drugbank_id": "DB00415",
                "name": "Ampicillin"
            }
        ]
    }
]

• New Added an endpoint to view therapeutic alternatives for a drug based on therapeutic categories.
• New Added endpoints to view drug alternatives for a product and a product concept based on therapeutic categories.

February 03, 2022

New section count metadata

{
  "pmg_section_count": 1,
  "hpi_section_count": 18,
  "sli_section_count": 8,
  "all_section_count": 27
}

• New Added total section counts for each drug label module (pmg, hpi, sli) as well as the entire label.

Oct 15, 2021

Get a specific Singapore product

curl -L 'https://api.drugbank.com/v1/products/SIN11734P?region=sg' 
-H 'Authorization: myapikey'

• New Added support for new region:
  • Singapore