API Documentation
โ† All tools
GET/api/v1/diseases/autocomplete

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

Authentication

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

Parameters

Query parameters

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

FieldDescription
nameDisease
efo_idEFO ID

Empty results: No matching rows (HTTP 200)

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