API Documentation
← All tools
GET
/api/v1/trials-map/hubsHubs
trials-mapAvailable on Free
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.
When to use it
- Load hub markers for the trials map
- Find map hubs matching a search term
- Filter map hubs by stage
Getting started
Base URL
https://app.caelrith.com/api/v1/toolsAuthentication
Include your API key in the x-api-key header.
Rate limit
Every call counts against your workspace’s daily quota for clinicalTrialsApiCallsPerDay. Exceeding it returns HTTP 429.
Plans and daily limits
| Plan | Available | Calls / day |
|---|---|---|
| free | yes | 50 |
| pro | yes | 200 |
| custom (default) | yes | 10,000 |
Plan defaults. A custom workspace may carry per-tenant overrides.
Parameters
Query parameters
No parameters.
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/trials-map/hubs"
Response envelope
Successful responses wrap the payload in a success flag.
{
"success": true,
"data": { /* payload */ },
"meta": { /* pagination, totals */ }
}Catalog version mcp-2026-10-28 · generated from the live MCP catalog