API Documentation
โ All tools
GET
/api/v1/diseases/autocompleteDisease Autocomplete
diseasesNo success wrapper
Resolve a partial or full disease name to canonical disease entries carrying an ontology CURIE (efo_id, e.g. EFO:0003767). Returns up to 10 name/efo_id matches. Use this to convert a disease name into the exact CURIE expected by the disease_id / efo_id filters on trial search, regulatory approvals and Medicare drug spending, instead of guessing an ontology id.
When to use it
- resolve a disease name to its EFO CURIE
- disambiguate a disease name before filtering trials, approvals or Medicare spending by ontology id
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 |
|---|---|---|---|
| q | string | Yes | Partial or full disease name to autocomplete (e.g. 'breast cancer', 'sickle cell disease'). |
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/diseases/autocomplete?q=your_q"
Response envelope
This endpoint returns an implicit 2xx response - there is no success flag in the body.
{
"data": { /* payload */ },
"meta": { /* pagination, totals */ }
}
// No "success" flag on this endpoint - any 2xx JSON is a success.Response shape
List responseDISEASES
Payload: data โ Diseases
Common row fields
| Field | Description |
|---|---|
| name | Disease |
| efo_id | EFO ID |
Empty results: No matching rows (HTTP 200)
Catalog version 0.0.0-generated ยท generated from the API source