/api/v1/tools/biology/prioritize-targetsPrioritize Targets
Rank molecular targets for a disease with approved drugs, trial activity, sponsors, and a novelty score. Useful for identifying promising targets for drug discovery. Targets are selected top-N by association score first, then re-ordered by sortBy - 'novelty' therefore means most novel among the top-scoring set, not globally. An unresolvable disease name, a malformed efo_id (missing its 'PREFIX:' part), or an unknown efo_id returns HTTP 500 with an explanatory error - correct the input rather than retrying it.
When to use it
- identify promising drug discovery targets for a disease
Getting started
Base URL
https://app.caelrith.com/api/v1/toolsAuthentication
Include your API key in the x-api-key header.
Required: provide at least one of: disease, efo_id
Parameters
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| disease | string | No | Disease name (fuzzy resolution). Either disease or efo_id must be provided. |
| efo_id | string | No | Disease CURIE (e.g., MONDO:0004975). Precise ontology ID. Takes precedence over disease. |
| topN | integer | No | Maximum number of targets to return (1-200, default 20). Selection is top-N by association score; sortBy only re-orders the selected set. Range: 1 to 200 |
| minScore | number | No | Minimum association score filter (0-1, default 0). Range: 0 to 1 |
| sortBy | string | No | Sort order: score, novelty, trials, approved (default score). Applied AFTER top-N selection - 'novelty' means most novel within the top-scoring set. Allowed values: score, novelty, trials, approved |
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/tools/biology/prioritize-targets?disease=your_disease"
Response envelope
Successful responses wrap the payload in a success flag.
{
"success": true,
"data": { /* payload */ },
"meta": { /* pagination, totals */ }
}Response shape
Payload: data.targets — Prioritized Targets
Exact total: data.total_targets
Common row fields
| Field | Description |
|---|---|
| target_name | Target |
| association_score | Score |
| approved_drugs | Approved Drugs |
| trials_in_disease | Trials |
| novelty_score | Novelty |
| target_id | Record identifier |
Empty results: No matching rows (HTTP 200)
data.total_targets is capped by topN (below topN = complete; equal = more may exist). Targets are selected top-N by association score first, then re-ordered by sortBy - 'novelty' ranks the most novel within the top-scoring set, not globally.
Catalog version 0.0.0-generated · generated from the API source