/api/v1/tools/biology/target-landscapeTarget Landscape
Explore the competitive landscape for a molecular target: all modulating drugs with approval status, safety warnings, max clinical phase (numeric, combining trial and indication evidence), trial counts, sponsors, and indications. A target that cannot be resolved returns HTTP 500 with an explanatory 'not found' error naming the input; a 200 with an empty drugs list means the target resolved but has no modulating drugs recorded.
When to use it
- full competitive landscape for a target across drugs and sponsors
Getting started
Base URL
https://app.caelrith.com/api/v1/toolsAuthentication
Include your API key in the x-api-key header.
Parameters
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| target | string | Yes | Molecular target name, gene symbol, or identifier (e.g., 'APP', 'ENSG00000142192', 'amyloid beta'). |
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/tools/biology/target-landscape?target=your_target"
Response envelope
Successful responses wrap the payload in a success flag.
{
"success": true,
"data": { /* payload */ },
"meta": { /* pagination, totals */ }
}Response shape
Payload: data.drugs โ Target Landscape - Drugs
Exact total: data.total_drugs
Common row fields
| Field | Description |
|---|---|
| drug_name | Drug |
| is_approved | Approved |
| max_phase | Max Phase |
| total_trials | Trials |
| drug_id | Record identifier |
Empty results: no_drugs_for_resolved_target (target resolved; no modulating drugs recorded)
max_phase is NUMERIC, combining indication and trial evidence: 0.5 = Early Phase 1, 1.5 = Phase 1/2, 2.5 = Phase 2/3, 0 = no phase evidence - render tier labels, never 'Phase 2.5'. total_drugs is the complete count of modulating drugs (no cap on this endpoint).
Catalog version 0.0.0-generated ยท generated from the API source