/api/v1/clinical-trials/sampleTrial Registry Sample
Return up to 5 recently updated trial documents from the registry. Cheap way to inspect the real document shape or to fetch exact OpenAlex topic-name strings to reuse with the topic search. Available on all workspace tiers. Researcher (OpenAlex PI) links are NOT included here - use Trial Full Record on one of the returned trial ids to get a trial's resolved PI author_key.
When to use it
- inspect recent trial document fields
- get an exact openalex topic_name for the topic search
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
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | number | No | Number of trials to return (1-5, default 1). (range 1-5; default 1) Range: 1 to 5 |
Example request
curl -H "x-api-key: YOUR_API_KEY" \ "https://app.caelrith.com/api/v1/clinical-trials/sample"
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
Payload: data — Sample Trials
Common row fields
| Field | Description |
|---|---|
| trial_id | ID |
| title | Title |
| status | Status |
| phase | Phase |
| start_date | Start Date |
| enrollment | Enrollment |
Empty results: No matching rows (HTTP 200)
Catalog version mcp-2026-10-28 · generated from the live MCP catalog