API Documentation
← API overview

Trials Map

3 endpoints · every section below is generated from the API catalog

GET/api/v1/trials-map/hubs

Hubs

Available on FreeFull reference →

Returns the hub locations shown on the trials map, optionally narrowed by a search term and a stage. Call it to populate the map's hub markers or to see which hubs match a given search and stage. Returns HTTP 500 with error "Map Load Failed" if the map data cannot be loaded.

Rate limit: clinicalTrialsApiCallsPerDay · Free plan: 50/day

Parameters

No parameters.

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/trials-map/hubs"
GET/api/v1/trials-map/hubs/:city/sites

Sites

Available on FreeFull reference →

Returns the trial sites for a hub city, optionally filtered by country, search term, stage, and coordinates. Call it to drill into a city's site locations on the trials map. Returns HTTP 500 with an error message if the drilldown data cannot be fetched.

Rate limit: clinicalTrialsApiCallsPerDay · Free plan: 50/day

Parameters

ParameterTypeRequiredDescription
city(path)stringYes

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/trials-map/hubs/{city}/sites"
GET/api/v1/trials-map/hubs/:city/sites/:siteName/trials

Trials

Available on FreeFull reference →

Returns the trials associated with a specific site within a city, with status and phase normalized. Call it to list trials for a named facility shown on the trials map. Optional query filters narrow by country, search term, and stage. Fails with 500 if the trials cannot be fetched.

Rate limit: clinicalTrialsApiCallsPerDay · Free plan: 50/day

Parameters

ParameterTypeRequiredDescription
city(path)stringYes
siteName(path)stringYes

Example request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://app.caelrith.com/api/v1/trials-map/hubs/{city}/sites/{siteName}/trials"