API Documentation
โ† All tools
GET/api/v1/tools/biology/drug-to-targets

Drug to Targets

biology

For a given drug (generic or brand), return all known molecular targets, mechanism of action, and related drug forms (salts, biosimilars). Targets are aggregated across the resolved drug and its salt/variant forms. A drug that cannot be resolved returns HTTP 500 with an explanatory 'not found' error naming the input - correct the drug name or report it is not in the graph; repeating the same input cannot succeed. A 200 with an empty targets list means the drug resolved but has no recorded molecular targets (common for older drugs or biologicals with debated mechanisms).

When to use it

  • understand a drug's mechanism of action
  • find the molecular targets of a drug

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
drugstringYesDrug name (e.g., 'lapatinib', 'Keytruda').

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/tools/biology/drug-to-targets?drug=your_drug"

Response envelope

Successful responses wrap the payload in a success flag.

{
  "success": true,
  "data": { /* payload */ },
  "meta": { /* pagination, totals */ }
}

Response shape

List responseTARGETS

Payload: data.targets โ€” Molecular Targets

Audit trail: data.audit_trail

Common row fields

FieldDescription
symbolSymbol
nameName
actionAction
mechanismMechanism

Empty results: no_targets_for_resolved_drug (drug resolved; no molecular targets recorded - common for older drugs or biologicals with debated mechanisms)

Catalog version 0.0.0-generated ยท generated from the API source