API Documentation
← All tools
GET/api/v1/clinical-trials/sample

Trial Registry Sample

clinical-trialsAvailable on FreeNo success wrapper

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

Authentication

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

PlanAvailableCalls / day
freeyes50
proyes200
custom (default)yes10,000

Plan defaults. A custom workspace may carry per-tenant overrides.

Parameters

Query parameters

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

List responseTRIALS

Payload: data — Sample Trials

Common row fields

FieldDescription
trial_idID
titleTitle
statusStatus
phasePhase
start_dateStart Date
enrollmentEnrollment

Empty results: No matching rows (HTTP 200)

Catalog version mcp-2026-10-28 · generated from the live MCP catalog