API Documentation
โ† All tools
GET/api/v1/tools/biology/target-landscape

Target Landscape

biology

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/tools

Authentication

Include your API key in the x-api-key header.

Parameters

Query parameters

ParameterTypeRequiredDescription
targetstringYesMolecular 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

List responseDRUGS

Payload: data.drugs โ€” Target Landscape - Drugs

Exact total: data.total_drugs

Common row fields

FieldDescription
drug_nameDrug
is_approvedApproved
max_phaseMax Phase
total_trialsTrials
drug_idRecord 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