Skip to content

1. API Token Generation

The BioHarmony GraphQL API is accessed by sending an Authorization Header, using a POST method (Postman or Linux Curl can be used for testing), which will generate an Authorization Token. The Authorization Header contains your Username (email) and Password separated by a colon.

It is possible to create up to 20 tokens per User.

There are three REST endpoints available (create, revoke, revokeall) through POST methods to manage API Tokens:


auth method


POST /api/v1/token/create/

basic auth

Sends Authentication Header for server to generate a token using basic auth.

Add a Header to the request: Authorization: Basic enc_to_base64(UserName:password)



Password: abc123

=> (combine into Authorization Header construct)

=> (server-side tokenization to check access)



Authorization: Basic YmlvaGFybW9ueUBiaW9oYXJtb255LmNvbTphYmMxMjM=


POST /api/v1/token/revoke/


Allows revoking specific token for a user authenticated with a token

Add to request Header  Authorization: Token <your token>

POST /api/v1/token/revokeall/

basic auth or token

Allows revoking all tokens for a user being authenticated either by a token or by basic auth

To trigger the endpoints use either Linux util Curl or

2. API Token Expiration

A generated API token has no expiration time limit. Tokens can be replaced at any time by using the revoke endpoint and generating a new token.

3. What Is Possible to Query

It is possible to perform any query if it is compliant with the current BioHarmony GraphQL Schema.

To explore BioHarmony GraphQL Schema, please use GraphiQL - an online tool that makes it’s easier to get started with a GraphQL-based API.

In the Docs panel of GraphiQL, also known as the Documentation Explorer, you can go through the schema definitions.

NOTE: you must be logged in BioHarmony to view the content.

Navigate through root Query to get started.

Root Mutation is currently not available for the Users of the BioHarmony GraphQL API.

4. Query Examples

NOTE: examples below don’t contain all available fields possible to query. Please explore BioHarmony GraphQL Schema for more details.



Query variables

Query All Drugs

The result section can contain any set of attributes from DrugType.

Example: Query common attributes for all drugs.

  query DrugSearch($search: String, $offset: Int, $limit: Int) {
  drugs(search: $search, offset: $offset, limit: $limit) {
    searchMatch {.
    result {
      commonInfo {


Example: Query commercial attributes for all drugs.

query DrugSearch ($search: String, $offset: Int, $limit: Int) { drugs(search: $search, offset: $offset, limit: $limit) {   matchedCount   searchMatch {     matchedField     matches   }   result {     id     name     commercialInfo {        therapeuticAreas {         areaName         meshId       }       atcCodes {         code         name       }     }   } }}

To get first 100 drugs please set the following variables:

{ "offset": 0, "limit": 100}

Change the limit to get more/fewer drugs.

Change the offset to get next 100 drugs.

Wildcard Searching (any string)

A similar request can be used for searching drugs with any specific piece of text string.

Note: This request allows to search first 100 drugs that contain string “Aba” in its name or in other fields.

{ "search": "Aba", "offset": 0, "limit": 100}

Query a Specific Drug

If you know a Drug name, you can use the drug query to access it which returns DrugType attributes.

Example: Query adverse events for a specific drug.

query Drug { drug (name: "Abacavir") {   id   name   adverseEvents {     total     fulfillExpediteCriteria     seriousEvents {       total       eventData {         category         count       }    }   } }}


Example: Query trends.

query Drug { drug (name: "Abacavir") {   id   name   trends {        databaseSource     queryTerm     articlesNumber     topTerms (category: diseaseOrSyndrome) {       cui       name       overallCount       timelineData {         date         count       }     }   } }}


Query All Report Sets

(e.g., COVID-19 Drugs Set)

Example: Get all report sets and their IDs.

query ReportSets { reportsets {   id   name }}


Example: Get more information about each report set.

query ReportSets { reportsets {   id   name   description   drugs {     id     name   }   totalReportsCount   accessibleReportsCount }}


Query a Specific Report Set

Example: Query a specific report, using a report ID.

query ReportSet { reportset (id: 1) {   id   name   description   drugs {     id     name   }   totalReportsCount   accessibleReportsCount }}


Query User Information

Example: Query user information, using a username.

query Me { me {   id   username   firstName   lastName   email   isStaff   isActive   dateJoined   subscriptiontype {     level     started     expires   }   verified   secondaryEmail }}


Query Current Subscription

Example: Query your subscription details.

query Subscription { subscription {       level   started   expires }}