API Documentation
← All tools
GET
/api/v1/trials-map/hubs/:city/sites/:siteName/trialsTrials
trials-mapAvailable on Free
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.
When to use it
- List trials at a named site in a city
- Filter a site's trials by country or stage
- Look up trials for a facility on the trials map
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
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| city(path) | string | Yes | |
| siteName(path) | string | Yes |
Query parameters
No parameters.
Example request
curl -H "x-api-key: YOUR_API_KEY" \
"https://app.caelrith.com/api/v1/trials-map/hubs/{city}/sites/{siteName}/trials"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