Drugs acting on the elements of a project, served from /new_api/projects/{projectId}/drugs.

1. Drug search

Looks up drugs in Open Targets and returns each drug with the targets it acts on, limited to the organism of the project (human when the project has none) and expanded with the map elements that match those targets. Search either by query (drug name) or by target (an element on the map given as TYPE:ID).

1.1. HTTP request

GET /minerva/new_api/projects/test_project/drugs:search?query=aspirin HTTP/1.1

1.2. Path Parameters

Table 1. /minerva/new_api/projects/{projectId}/drugs:search
Parameter Description

projectId

project identifier

1.3. Query Parameters

Parameter Description

query

name of drug that we are searching for

target

target element that we are searching for in format TYPE:ID

1.4. CURL sample

$ curl 'https://minerva-dev.lcsb.uni.lu/minerva/new_api/projects/test_project/drugs:search?query=aspirin' -X GET \
    -H 'Authorization: Bearer xxxxxxxx'

1.5. HTTP response

HTTP/1.1 200 OK

1.6. Response Fields

Path Type Description

[].id

String

identifier of the drug

[].name

String

name of the drug

[].description

String

summary of the drug taken from the source database

[].synonyms

Array

list of synonyms

[].brandNames

Array

list of brand names

[].bloodBrainBarrier

String

does drug cross blood brain barrier

[].references

Array

list of references that identify sources

[].targets

Array

list of targets

[].targets[].name

String

target name

[].targets[].references

Array

list of target references

[].targets[].source

Object

source database of the target

[].targets[].targetElements

Array

list of elements on the map associated with this target

[].targets[].targetParticipants

Array

list of identifiers associated with this target

1.7. Sample Response

[ {
  "name" : "ASPIRIN",
  "references" : [ {
    "link" : "https://www.ebi.ac.uk/chembl/compound/inspect/CHEMBL25",
    "type" : "CHEMBL_COMPOUND",
    "resource" : "CHEMBL25",
    "id" : 0,
    "annotator" : null
  } ],
  "description" : "Drug used to reduce pain, fever and inflammation.",
  "bloodBrainBarrier" : "permeable",
  "brandNames" : [ "Aspirin" ],
  "synonyms" : [ "acetylsalicylic acid" ],
  "id" : "ASPIRIN",
  "targets" : [ {
    "source" : {
      "link" : null,
      "type" : "HGNC",
      "resource" : "3023",
      "id" : 0,
      "annotator" : null
    },
    "name" : "DRD2",
    "targetParticipants" : [ {
      "link" : "https://www.genenames.org/data/gene-symbol-report/#!/symbol/DRD2",
      "type" : "HGNC_SYMBOL",
      "resource" : "DRD2",
      "id" : 0,
      "annotator" : null
    } ],
    "references" : [ {
      "link" : "https://pubmed.ncbi.nlm.nih.gov/12345678/",
      "article" : null,
      "type" : "PUBMED",
      "resource" : "12345678",
      "id" : 0,
      "annotator" : null
    } ],
    "targetElements" : [ ]
  } ]
} ]

2. Suggested query list

Returns a list of suggested search queries for drugs in the project.

2.1. HTTP request

GET /minerva/new_api/projects/test_project/drugs/suggested_query_list HTTP/1.1

2.2. Path Parameters

Table 2. /minerva/new_api/projects/{projectId}/drugs/suggested_query_list
Parameter Description

projectId

project identifier

2.3. CURL sample

$ curl 'https://minerva-dev.lcsb.uni.lu/minerva/new_api/projects/test_project/drugs/suggested_query_list' -X GET \
    -H 'Authorization: Bearer xxxxxxxx'

2.4. HTTP response

HTTP/1.1 200 OK

2.5. Response Fields

Path Type Description

[]

Array

list of suggested queries

2.6. Sample Response

[ "aspirin", "levodopa" ]