Biological Associations

biology

Discover target-disease or disease-target associations with confidence scores and evidence counts. Resolves the input entity against targets first, then diseases (direct ID, exact, fuzzy and vector search). An entity that cannot be resolved returns HTTP 500 with an explanatory 'not found' error naming the input - correct the entity name or report it is not in the graph; repeating the same input cannot succeed. A 200 with an empty associations list means the entity resolved but nothing met minScore.

When to use it

find targets associated with a disease
explore evidence for a target-disease link

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

Parameter	Type	Required	Description
entity	string	Yes	Biological entity name or ID (e.g., 'EGFR', 'diabetes').
minScore	number	No	Minimum confidence score between 0 and 1 (default 0.1). Range: 0 to 1
limit	integer	No	Maximum number of associations (1-100, default 50). Range: 1 to 100

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/tools/biology/associations?entity=your_entity"

Response envelope

Successful responses wrap the payload in a success flag.

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

Response shape

List responseASSOCIATIONS

Payload: data.associations — Associations

Exact total: data.count

Audit trail: data.audit_trail

Common row fields

Field	Description
linked_entity	Linked Entity
type	Type
association_score	Score
evidence_count	Evidence
linked_id	Record identifier

Empty results: No matching rows (HTTP 200)

data.count is the number of associations RETURNED after the limit filter (max 100): below limit it is the full filtered total; equal to limit means more associations may exist above minScore. Do not present it as the entity's complete association count when it equals limit.

Catalog version 0.0.0-generated · generated from the API source