NAV
shell

Introduction

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

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

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

Selecting your country/region

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

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

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

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

The following country/codes are available:

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

Searching without a region

You can search for all drugs / products by not providing a region scope. This will allow you to get information about drugs that are not marketed (experimental, illicit, etc.).

Authentication

To authorize, use this code:

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

Make sure to replace mytoken with your API key.

DrugBank uses API keys to allow access to the API. You can register a new DrugBank API key at our developer portal.

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

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

Authorization: mytoken

Pagination

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

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

Query Parameters

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

Response Headers

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

Errors

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

The DrugBank API uses the following error codes:

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

Content Types

Response Body

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

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

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

Request Headers

Header Description
Accept Requested MIME type of response.

Response Headers

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

Request Body

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

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

Request Headers

Header Description
Content-Type MIME type of request body.

Drug Names / Autocomplete

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

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

The above command returns JSON structured like this (only the first result shown):

{
  "products": [
    {
      "hits": [
        {
          "field": "name",
          "value": "<em>Viagra</em>"
        }
      ],
      "name": "Viagra",
      "ndc_product_codes": [
        "55154-2727",
        "..."
      ],
      "dosage_form": "tablet, film coated",
      "strength_number": "25",
      "strength_unit": "mg/1",
      "route": "oral",
      "generic": false,
      "otc": false,
      "mixture": false,
      "ingredients": [
        {
          "drugbank_id": "DB00203",
          "name": "Sildenafil",
          "cas": "139755-83-2",
          "strength_number": "25",
          "strength_unit": "mg/1"
        }
      ],
      "images": [
        {
          "ndc_id": "55154-2727",
          "description": "sildenafil 25 MG Oral Tablet [Viagra]",
          "image_url_original": "...",
          "image_url_tiny": "...",
          "image_url_thumb": "...",
          "image_url_medium": "..."
        }
      ]
    }
  ]
}

HTTP Request

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

Query Parameters

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

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

The above command returns JSON structured like this (only the first result shown):

{
  "products": [
    {
      "hits": [
        {
          "field": "name",
          "value": "<em>Viagra</em> 50 MG Oral Tablet"
        }
      ],
      "name": "Viagra 50 MG Oral Tablet",
      "brands": [
        "Viagra"
      ],
      "ndc_product_codes": [
        "21695-157"
      ],
      "dosage_forms": [
        "tablet, film coated"
      ],
      "strength_number": "50",
      "strength_unit": "mg/1",
      "route": "oral",
      "ingredients": [
        {
          "drugbank_id": "DB00203",
          "name": "Sildenafil",
          "cas": "139755-83-2",
          "strength_number": "50",
          "strength_unit": "mg/1"
        }
      ]
    }
  ]
}

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

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

HTTP Request

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

Query Parameters

Parameter Default Description
search 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 “Advil”, with fuzzy search enabled you will still get a result (try it yourself!).

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

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

Products

Get a specific U.S. product

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

The above command returns JSON structured like this:

{
  "ndc_product_code": "55154-2727",
  "dpd_id": null,
  "name": "Viagra",
  "started_marketing_on": "1998-03-27",
  "approved_on": null,
  "schedule": null,
  "dosage_form": "tablet, film coated",
  "route": "oral",
  "application_number": "NDA020895",
  "generic": false,
  "otc": false,
  "approved": true,
  "country": true,
  "mixture": false,
  "ingredients": [
    {
      "name": "Sildenafil",
      "drugbank_id": "DB00203",
      "strength": {
        "number": "25",
        "unit": "mg/1"
      }
    }
  ]
}

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

HTTP Request

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

URL Parameters

Parameter Description
ID The NDC ID of the product to retrieve

Get a specific Canadian product

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

The above command returns JSON structured like this:

{
  "ndc_product_code": "55154-2727",
  "dpd_id": null,
  "name": "Viagra",
  "started_marketing_on": "1998-03-27",
  "approved_on": null,
  "schedule": null,
  "dosage_form": "tablet, film coated",
  "route": "oral",
  "application_number": "NDA020895",
  "generic": false,
  "otc": false,
  "approved": true,
  "country": true,
  "mixture": false,
  "ingredients": [
    {
      "name": "Sildenafil",
      "drugbank_id": "DB00203",
      "strength": {
        "number": "25",
        "unit": "mg/1"
      }
    }
  ]
}

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

HTTP Request

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

URL Parameters

Parameter Description
ID The DPD ID of the product to retrieve

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

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

The above command returns JSON structured like this:

[{
  "ndc_product_code": null,
  "dpd_id": null,
  "ema_product_code": "EMEA/H/C/002673",
  "ema_ma_number": "EU/1/13/886/001",
  "name": "Relvar Ellipta",
  "started_marketing_on": "2013-11-13",
  "approved_on": null,
  "schedule": null,
  "dosage_form": "Inhalation powder, pre-dispensed",
  "route": "Inhalation use",
  "application_number": null,
  "generic": false,
  "otc": false,
  "approved": true,
  "country": true,
  "mixture": true,
  "ingredients": [
    {
      "name": "Fluticasone furoate",
      "drugbank_id": "DB08906",
      "strength": {
        "number": "92",
        "unit": "micrograms"
      }
    },
    {
      "name": "Vilanterol",
      "drugbank_id": "DB09082",
      "strength": {
        "number": "22",
        "unit": "micrograms"
      }
    }
  ]
}]

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

HTTP Request

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

URL Parameters

Parameter Description
ID The EMA ID of the product to retrieve

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

curl -L 'https://api.drugbankplus.com/v1/eu/products/EU/1/13/886/001' 
-H 'Authorization: mytoken'

The above command returns JSON structured like this:

{
  "ndc_product_code": null,
  "dpd_id": null,
  "ema_product_code": "EMEA/H/C/002673",
  "ema_ma_number": "EU/1/13/886/001",
  "name": "Relvar Ellipta",
  "started_marketing_on": "2013-11-13",
  "approved_on": null,
  "schedule": null,
  "dosage_form": "Inhalation powder, pre-dispensed",
  "route": "Inhalation use",
  "application_number": null,
  "generic": false,
  "otc": false,
  "approved": true,
  "country": true,
  "mixture": true,
  "ingredients": [
    {
      "name": "Fluticasone furoate",
      "drugbank_id": "DB08906",
      "strength": {
        "number": "92",
        "unit": "micrograms"
      }
    },
    {
      "name": "Vilanterol",
      "drugbank_id": "DB09082",
      "strength": {
        "number": "22",
        "unit": "micrograms"
      }
    }
  ]
}

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

HTTP Request

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

URL Parameters

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

Drugs

Get a specific drug

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

The above command returns JSON structured like this:

{
  "drugbank_id": "DB00316",
  "name": "Acetaminophen",
  "description": "Acetaminophen, also known as paracetamol, is ...",
  "synonyms": ["..."],
  "pharmacology": {
    "indication_descripton": "For temporary relief of fever, minor aches, and pains.",
    "pharmacodynamic_description": "Acetaminophen (USAN) or Paracetamol (INN) is a ...",
    "mechanism_of_action_description": "Acetaminophen is thought to act primarily in the ...",
    "absorption": "Rapid and almost complete",
    "protein_binding": "25%",
    "volume_of_distribution": [],
    "clearance": [],
    "half_life": "1 to 4 hours",
    "route_of_elimination": "Approximately 80% of acetaminophen is ...",
    "toxicity_description": "Oral, mouse: LD50 = 338 mg/kg; Oral, rat: LD50 = 1944 mg/kg. Acetaminophen is ..."
  },
  "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": "InChIKey=RZVAJINKPMORJF-UHFFFAOYSA-N"
  }
}

This endpoint retrieves a specific drug based on DrugBank ID.

HTTP Request

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

URL Parameters

Parameter Description
ID The DrugBank ID of the drug to retrieve

Get products linked with a drug

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

The above command returns JSON structured like this (only first product shown):

[
  {
    "ndc_product_code": null,
    "dpd_id": "02236871",
    "name": "(extra Strength) Acetaminophen, Caffeine & 8mg Codeine Phosphate Caplets",
    "started_marketing_on": "1998-07-22",
    "approved_on": null,
    "schedule": "Narcotic (CDSA I)",
    "dosage_form": "tablet",
    "route": "oral",
    "application_number": null,
    "generic": false,
    "otc": false,
    "approved": true,
    "country": true,
    "mixture": true,
    "ingredients": [
      {
        "name": "Caffeine",
        "drugbank_id": "DB00201",
        "strength": {
          "number": "15",
          "unit": "mg"
        }
      }
    ]
  }
]

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

HTTP Request

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

URL Parameters

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

Get Categories for a Drug

curl -L 'https://api.drugbankplus.com/v1/ca/drugs/DB000993/categories' 
-H 'Authorization: mytoken'
[
    {
        "drugbank_id": "DBCAT001220",
        "alternate_drugbank_ids": [],
        "mesh_identifier": "D015122",
        "atc_code": "L01BB02",

        "title": "6-Mercaptopurine",
        "synonyms": [
            "1,7-Dihydro-6H-purine-6-thione",
            "6 Mercaptopurine",
            "6 Mercaptopurine Monohydrate"
        ],
        "description": "An antimetabolite ...... "
    }
]

Returns an array of categories for a drug, based on the DrugBank ID. 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 tree, but parent/child relationships will be limited based on tree.

HTTP Request

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

URL Parameters

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

Get Indications linked with a drug

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

The above command returns JSON structured like this (only first indication shown):

[
  {
    "off_label": true,
    "otc_use": false,
    "kind": "treatment_of",
    "sex_group": "female",
    "condition": {
      "name": "Precocious puberty",
      "drugbank_id": "DBCOND000004",
      "meddra_id": "llt\/10058084",
      "icd10_id": "c\/E30.1"
    },
    "condition_associated_with": [
      {
        "name": "McCune-Albright syndrome",
        "drugbank_id": "DBCOND000005",
        "meddra_id": "llt\/10051698",
        "icd10_id": "c\/Q78.1"
      }
    ]
  }
]

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

HTTP Request

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

URL Parameters

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

Query Parameters

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

Drug-Drug Interactions

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

Find DDI With Product Codes

Return a list of drug interactions involving the products with the NDC codes 66715-9833 and 0002-7140:

curl -L 'https://api.drugbankplus.com/v1/ddi?ndc=66715-9833,0002-7140' 
-H 'Authorization: mytoken'

The interacting ingredients in each product are identified by name and DrugBank identifier. The result looks like:

{
  "total_results": 1,
  "interactions": [
    {
      "product": "66715-9833",
      "product_ingredient": {
        "drugbank_id": "DB01050",
        "name": "Ibuprofen"
      },
      "affected_product": "0002-7140",
      "affected_product_ingredient": {
        "drugbank_id": "DB00054",
        "name": "Abciximab"
      },
      "action": "increase_anticoagulant_effect",
      "description": "Ibuprofen may increase the anticoagulant activities of Abciximab.",
      "severity": "Moderate"
    }
  ]
}

HTTP Request

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

Query Parameters

Parameter Description
names A comma delimited list of NDC codes

To search by the NDC product code the ndc codes should be joined with a comma, and not include any quotations. Only the 2 segment NDC code is accepted at this time.

Find DDI With Name

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

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

The above command returns the interactions associated with the product specified by the product name.

{
    "total_results": 6,
    "interactions": [
        {
            "product_name": "Reopro",
            "product_ingredient": {
                "drugbank_id": "DB00054",
                "name": "Abciximab"
            },
            "affected_product_name": "Eliquis",
            "affected_product_ingredient": {
                "drugbank_id": "DB06605",
                "name": "Apixaban"
            },
            "action": "increase_adverse_effects",
            "description": "The risk or severity of adverse effects can be increased when Abciximab is combined with Apixaban.",
            "severity": "Minor"
        },
        {
            "product_name": "Advil",
            "product_ingredient": {
                "drugbank_id": "DB01050",
                "name": "Ibuprofen"
            },
            "affected_product_name": "Reopro",
            "affected_product_ingredient": {
                "drugbank_id": "DB00054",
                "name": "Abciximab"
            },
            "action": "increase_anticoagulant_effect",
            "description": "Ibuprofen may increase the anticoagulant activities of Abciximab.",
            "severity": "Moderate"
        },
        {
            "product_name": "7-select Advil PM",
            "product_ingredient": {
                "drugbank_id": "DB01050",
                "name": "Ibuprofen"
            },
            "affected_product_name": "Reopro",
            "affected_product_ingredient": {
                "drugbank_id": "DB00054",
                "name": "Abciximab"
            },
            "action": "increase_anticoagulant_effect",
            "description": "Ibuprofen may increase the anticoagulant activities of Abciximab.",
            "severity": "Moderate"
        },
        {
            "product_name": "Advil",
            "product_ingredient": {
                "drugbank_id": "DB01050",
                "name": "Ibuprofen"
            },
            "affected_product_name": "Eliquis",
            "affected_product_ingredient": {
                "drugbank_id": "DB06605",
                "name": "Apixaban"
            },
            "action": "increase_adverse_effects",
            "description": "The risk or severity of adverse effects can be increased when Ibuprofen is combined with Apixaban.",
            "severity": "Minor"
        },
        {
            "product_name": "7-select Advil PM",
            "product_ingredient": {
                "drugbank_id": "DB01050",
                "name": "Ibuprofen"
            },
            "affected_product_name": "Eliquis",
            "affected_product_ingredient": {
                "drugbank_id": "DB06605",
                "name": "Apixaban"
            },
            "action": "increase_adverse_effects",
            "description": "The risk or severity of adverse effects can be increased when Ibuprofen is combined with Apixaban.",
            "severity": "Minor"
        },
        {
            "product_name": "Eliquis",
            "product_ingredient": {
                "drugbank_id": "DB06605",
                "name": "Apixaban"
            },
            "affected_product_name": "Reopro",
            "affected_product_ingredient": {
                "drugbank_id": "DB00054",
                "name": "Abciximab"
            },
            "action": "increase_anticoagulant_effect",
            "description": "Apixaban may increase the anticoagulant activities of Abciximab.",
            "severity": "Major"
        }
    ]
}

HTTP Request

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

Request Body

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

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

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

Indications

Common Query Parameter Values

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

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

Search indications

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

The above command returns JSON structured like this:

[{
  "drug": {
    "name": "Triamcinolone",
    "drugbank_id": "DB00620"
  },
  "off_label": false,
  "otc_use": false,
  "kind": "symptomatic_treatment_of",
  "condition": {
    "name": "Rheumatoid arthritis",
    "meddra_id": "llt/10039073",
    "icd10_id": "c/M06.9"
  }
}]

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

HTTP Request

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

Query Parameters

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

The above command returns JSON structured like this:

[{
  "drugbank_id": "DB00316",
  "name": "Acetaminophen",
  "description": "Acetaminophen, also known as paracetamol, is ...",
  "synonyms": ["..."],
  "pharmacology": {
    "indication_descripton": "For temporary relief of fever, minor aches, and pains.",
    "pharmacodynamic_description": "Acetaminophen (USAN) or Paracetamol (INN) is a ...",
    "mechanism_of_action_description": "Acetaminophen is thought to act primarily in the ...",
    "absorption": "Rapid and almost complete",
    "protein_binding": "25%",
    "volume_of_distribution": [],
    "clearance": [],
    "half_life": "1 to 4 hours",
    "route_of_elimination": "Approximately 80% of acetaminophen is ...",
    "toxicity_description": "Oral, mouse: LD50 = 338 mg/kg; Oral, rat: LD50 = 1944 mg/kg. Acetaminophen is ..."
  },
  "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": "InChIKey=RZVAJINKPMORJF-UHFFFAOYSA-N"
  }
}]

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

HTTP Request

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

Example: Search indications by condition and more specific forms

HTTP Request

GET /v1/indications?q=autoimmune+disorders&more=specific

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

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

Conditions

Common Query Parameter Values

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

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

Search conditions

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

The above command returns JSON structured like this:

[{
    "name": "Rheumatoid arthritis",
    "drugbank_id": "DBCOND00006",
    "meddra_id": "llt/10039073",
    "icd10_id": "c/M06.9"
}]

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

HTTP Request

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

Query Parameters

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

Get a condition

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

The above command returns JSON structured like this: (note that parts of the result have been removed for brevity)

{
  "condition": {
    "name": "Gout",
    "meddra_id": "llt/10018627",
    "icd10_id": "c/M10",
    "drugbank_id": "DBCOND000008",
    "more_general": [
      {
        "name": "Crystal arthropathic disorders",
        "meddra_id": "hlt/10011505",
        "icd10_id": null,
        "drugbank_id": "DBCOND000032"
      },
      {
        "name": "Joint disorders",
        "meddra_id": "hlgt/10023213",
        "icd10_id": "c/M25.9",
        "drugbank_id": "DBCOND000011"
      }
    ],
    "more_specific": [
      {
        "name": "Gout attack",
        "meddra_id": "llt/10018634",
        "icd10_id": "c/M10",
        "drugbank_id": "DBCOND000010"
      },
      {
        "name": "acute Gouty arthritis",
        "meddra_id": "llt/10018634",
        "icd10_id": "c/M10",
        "drugbank_id": "DBCOND000009"
      }
    ],
    "indications": [
      {
        "kind": "adjunct_therapy_in_treatment_of",
        "off_label": false,
        "otc_use": false,
        "drug": {
          "name": "Cosyntropin",
          "drugbank_id": "DB01284"
        },
        "regions": "Canada",
        "condition": {
          "name": "Gout",
          "meddra_id": "llt/10018627",
          "icd10_id": "c/M10",
          "drugbank_id": "DBCOND000008"
        }
      }
    ]
  }
}

URL Parameters

Parameter Description
ID Condition ID

Get indications linked to a condition

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

The above command returns data structured like this:

 [
  {
    "kind": "adjunct_therapy_in_treatment_of",
    "off_label": false,
    "otc_use": false,
    "drug": {
      "name": "Cosyntropin",
      "drugbank_id": "DB01284"
    },
    "regions": "Canada",
    "condition": {
      "name": "Gout",
      "meddra_id": "llt/10018627",
      "icd10_id": "c/M10",
      "drugbank_id": "DBCOND000008"
    }
  }
]

This endpoint retrieves indications linked to a condition.

HTTP Request

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

URL Parameters

Parameter Description
ID Condition ID

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 drugs linked to a condition via indications

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

The above command returns JSON structured like this:

[
  {
    "drugbank_id": "DB00316",
    "name": "Acetaminophen",
    "description": "Acetaminophen, also known as paracetamol, is ...",
    "synonyms": ["..."],
    "pharmacology": {
      "indication_descripton": "For temporary relief of fever, minor aches, and pains.",
      "pharmacodynamic_description": "Acetaminophen (USAN) or Paracetamol (INN) is a ...",
      "mechanism_of_action_description": "Acetaminophen is thought to act primarily in the ...",
      "absorption": "Rapid and almost complete",
      "protein_binding": "25%",
      "volume_of_distribution": [],
      "clearance": [],
      "half_life": "1 to 4 hours",
      "route_of_elimination": "Approximately 80% of acetaminophen is ...",
      "toxicity_description": "Oral, mouse: LD50 = 338 mg/kg; Oral, rat: LD50 = 1944 mg/kg. Acetaminophen is ..."
    },
    "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": "InChIKey=RZVAJINKPMORJF-UHFFFAOYSA-N"
    }
  }
]

This endpoint retrieves drugs linked to a condition via indications.

HTTP Request

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

URL Parameters

Parameter Description
ID Condition ID

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.

Get more general forms of a condition

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

The above command returns data structured like this:

[{
  "name": "Crystal arthropathic disorders",
  "meddra_id": "hlt/10011505",
  "icd10_id": null,
  "drugbank_id": "DBCOND000032"
},
{
  "name": "Joint disorders",
  "meddra_id": "hlgt/10023213",
  "icd10_id": "c/M25.9",
  "drugbank_id": "DBCOND000011"
}]

This endpoint retrieves more general forms of a condition.

HTTP Request

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

URL Parameters

Parameter Description
ID Condition ID

Get more specific forms of a condition

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

The above command returns data structured like this:

[{
  "name": "Gout attack",
  "meddra_id": "llt/10018634",
  "icd10_id": "c/M10",
  "drugbank_id": "DBCOND000010"
},
{
  "name": "acute Gouty arthritis",
  "meddra_id": "llt/10018634",
  "icd10_id": "c/M10",
  "drugbank_id": "DBCOND000009"
}]

This endpoint retrieves more specific forms of a condition.

HTTP Request

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

URL Parameters

Parameter Description
ID Condition ID
curl -L 'https://api.drugbankplus.com/v1/ca/conditions/<ID>/references' 
-H 'Authorization: mytoken'

The above command returns data structured like this:

[{
  "name": "Gout attack",
  "meddra_id": "llt/10018634",
  "icd10_id": "c/M10",
  "drugbank_id": "DBCOND000010"
},
{
  "name": "acute Gouty arthritis",
  "meddra_id": "llt/10018634",
  "icd10_id": "c/M10",
  "drugbank_id": "DBCOND000009"
}]

This endpoint retrieves related condtions.

HTTP Request

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

URL Parameters

Parameter Description
ID Condition ID

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
tree blank or all Include children/parents from any hierarchy
tree atc Include children/parents from the ATC hierarchy
tree mesh Include children/parents from the MeSH hierarchy

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

ATC and MeSH identifiers

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

View Category

curl -L 'https://api.drugbankplus.com/v1/ca/categories/DBCAT001220' 
-H 'Authorization: mytoken'
{
    "drugbank_id": "DBCAT001220",
    "alternate_drugbank_ids": [],
    "mesh_identifier": "D015122",
    "mesh_tree_numbers": [
        "D27.505.519.389.745"
    ],

    "atc_code": "L01BB02",
    "atc_level": 5,

    "title": "6-Mercaptopurine",
    "synonyms": [
        "1,7-Dihydro-6H-purine-6-thione",
        "6 Mercaptopurine",
        "6 Mercaptopurine Monohydrate"
    ],
    "description": "An antimetabolite ...... "
}

This endpoint retrieves a specific category based on DrugBank ID.

HTTP Request

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

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

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

URL Parameters

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

View Category by ATC code

curl -L 'https://api.drugbankplus.com/v1/ca/categories/atc/L01BB01' 
-H 'Authorization: mytoken'
{
    "drugbank_id": "DBCAT001220",
    "alternate_drugbank_ids": [],
    "mesh_identifier": "D015122",
    "mesh_tree_numbers": [
        "D27.505.519.389.745"
    ],

    "atc_code": "L01BB02",
    "atc_level": 5,

    "title": "6-Mercaptopurine",
    "synonyms": [
        "1,7-Dihydro-6H-purine-6-thione",
        "6 Mercaptopurine",
        "6 Mercaptopurine Monohydrate"
    ],
    "description": "An antimetabolite ...... "
}

This endpoint retrieves a specific category based on ATC Code.

HTTP Requests

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

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

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

URL Parameters

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

View Category by MeSH Unique ID

curl -L 'https://api.drugbankplus.com/v1/ca/categories/mesh/D015122' 
-H 'Authorization: mytoken'
{
    "drugbank_id": "DBCAT001220",
    "alternate_drugbank_ids": [],
    "mesh_identifier": "D015122",
    "mesh_tree_numbers": [
        "D27.505.519.389.745"
    ],

    "atc_code": "L01BB02",
    "atc_level": 5,

    "title": "6-Mercaptopurine",
    "synonyms": [
        "1,7-Dihydro-6H-purine-6-thione",
        "6 Mercaptopurine",
        "6 Mercaptopurine Monohydrate"
    ],
    "description": "An antimetabolite ...... "
}

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

HTTP Requests

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

URL Parameters

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

View Parents of a Category

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

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

Note that in the example output, only the mesh_identifier and parents keys are shown, to illustrate the effect of providing an include_parents=3 parameter.

This endpoint supports pagination.

[
  {
    "mesh_identifier": "D045504",
    "parents": [
      {
          "mesh_identifier": "D045504",
          "parents": [
              {
                  "mesh_identifier": "D020228",
                  "parents": [
                      { "mesh_identifier": "D27" },
                  ]
              },
          ]
      },
    ]
  }
]
curl -L 'https://api.drugbankplus.com/v1/ca/categories/mesh/D004791/parents' 
-H 'Authorization: mytoken'
curl -L 'https://api.drugbankplus.com/v1/ca/categories/atc/A01/parents' 
-H 'Authorization: mytoken'

HTTP Requests

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

URL Parameters

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

View Children of a Category

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

This endpoint supports pagination.

curl -L 'https://api.drugbankplus.com/v1/ca/categories/DBCAT002118/children?tree=atc' 
-H 'Authorization: mytoken'
[
  {
    "drugbank_id": "DBCAT000230",
    "name": "Vitamins",
    "mesh_id": "D014815",
    "mesh_tree_numbers": [
      "D27.505.696.377.605.600",
      "G07.203.300.631.600",
      "J02.500.631.600"
    ],
    "atc_code": "A11",
    "atc_level": 2,
    "synonyms": [
      "Vitamin"
    ],
    "description": "Organic substances that are required in small amounts for maintenance and growth, but which cannot be manufactured by the human body."
  },
  {
    "drugbank_id": "DBCAT000780",
    "name": "Appetite Stimulants",
    "mesh_id": "D019167",
    "mesh_tree_numbers": [
      "D27.505.696.282.050",
      "D27.505.954.427.220.050"
    ],
    "atc_code": "A15",
    "atc_level": 2,
    "synonyms": [
      "Appetite Stimulating Drugs",
      "Appetite-Stimulating Drugs",
      "Drugs, Appetite-Stimulating",
      "Stimulants, Appetite"
    ],
    "description": "Agents that are used to stimulate appetite. These drugs are frequently used to treat anorexia associated with cancer and AIDS."
  }
]
curl -L 'https://api.drugbankplus.com/v1/ca/categories/mesh/D045504/children' 
-H 'Authorization: mytoken'
curl -L 'https://api.drugbankplus.com/v1/ca/categories/atc/A/children' 
-H 'Authorization: mytoken'

HTTP Requests

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

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

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

URL Parameters

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

Get Drugs in a Category

Returns all drugs in this category.

This endpoint supports pagination.

curl -L 'https://api.drugbankplus.com/v1/ca/categories/DBCAT001220/drugs' 
-H 'Authorization: mytoken'
[
    {
          "drugbank_id": "DB00993", "name": "Azathioprine", "description": "An immunosuppressive antimetabolite pro-drug. It is an imidazolyl derivative of 6-mercaptopurine and many of its biological effects are similar to those of the parent compound. Azathioprine is converted into 6-mercaptopurine in the body where it blocks purine metabolism and DNA synthesis.",
          "synonyms": [
            "6-((1-Methyl-4-nitro-1H-imidazol-5-yl)thio)-1H-purine",
            "6-(1'-Methyl-4'-nitro-5'-imidazolyl)-mercaptopurine",
            "Imuran (tn)"
          ],
          "pharmacology": {
            "indication_descripton": "For use in rheumatoid arthritis, preventing renal transplant rejection, Crohn's disease, and colitis.",
            "pharmacodynamic_description": "Azathioprine is a chemotherapy drug, now rarely used for chemotherapy but more for immunosuppression in organ transplantation and autoimmune disease such as rheumatoid arthritis or inflammatory bowel disease or Crohn's disease. It is a pro-drug, converted in the body to the active metabolite 6-mercaptopurine. Azathioprine acts to inhibit purine synthesis necessary for the proliferation of cells, especially leukocytes and lymphocytes. It is a safe and effective drug used alone in certain autoimmune diseases, or in combination with other immunosuppressants in organ transplantation. Its most severe side effect is bone marrow suppression, and it should not be given in conjunction with purine analogues such as allopurinol. The enzyme thiopurine S-methyltransferase (TPMT) deactivates 6-mercaptopurine. Genetic polymorphisms of TPMT can lead to excessive drug toxicity, thus assay of serum TPMT may be useful to prevent this complication.",
            "mechanism_of_action_description": "Azathioprine antagonizes purine metabolism and may inhibit synthesis of DNA, RNA, and proteins. It may also interfere with cellular metabolism and inhibit mitosis. Its mechanism of action is likely due to incorporation of thiopurine analogues into the DNA structure, causing chain termination and cytotoxicity.",
            "absorption": "Well absorbed following oral administration.",
            "protein_binding": "Azathioprine and the metabolite mercaptopurine are moderately bound to serum proteins (30%).",
            "volume_of_distribution": [],
            "clearance": [],
            "half_life": "",
            "route_of_elimination": "Both compounds are rapidly eliminated from blood and are oxidized or methylated in erythrocytes and liver; no azathioprine or mercaptopurine is detectable in urine after 8 hours. ",
            "toxicity_description": "The oral LD<sub>50</sub> for single doses of azathioprine in mice and rats are 2500 mg/kg and 400 mg/kg, respectively. Very large doses of this antimetabolite may lead to marrow hypoplasia, bleeding, infection, and death."
          },
          "identifiers": {
            "drugbank_id": "DB00993",
            "inchi": "InChI=1S/C9H7N7O2S/c1-15-4-14-7(16(17)18)9(15)19-8-5-6(11-2-10-5)12-3-13-8/h2-4H,1H3,(H,10,11,12,13)",
            "inchikey": "LMEKQMALGUDUQG-UHFFFAOYSA-N"
          }
        }
]
curl -L 'https://api.drugbankplus.com/v1/ca/categories/atc/L01BB01/drugs' 
-H 'Authorization: mytoken'
curl -L 'https://api.drugbankplus.com/v1/ca/categories/mesh/D015122/drugs' 
-H 'Authorization: mytoken'

HTTP Requests

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

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

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

URL Parameters

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

Category Names / Autocomplete

This endpoint returns a list of categories suitable for use with autocomplete forms, for quickly finding the right categories.

This endpoint supports pagination.

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

The above command returns JSON structured like this (only the first result shown):

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

HTTP Request

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

Query Parameters

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

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

Fuzzy Searching

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

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

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

API Versions

Accessing API versions

All previous versions of our API documentation are available:

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

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

https://docs.drugbankplus.com

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