Catalog / ToolMint ClinicalTrials.gov JSON
Coming soon Research & health
ToolMint ClinicalTrials.gov JSON
Clinical trial search and lookup from ClinicalTrials.gov as flat agent JSON: status, phase, sponsor, sites, and eligibility split into inclusion/exclusion lists. Provenance + attribution on every paid response. No personal contact data.
Routes and prices
| Route | Price | What it does | Parameters (* required) |
|---|---|---|---|
GET /trials | $0.01 | Search studies by condition / intervention / location / status / phase | condition, intervention, term, location, sponsor, status, phase, lat, lon, radiusMi, pageSize, pageToken |
GET /trials/{nctId} | $0.01 | One study by NCT number | nctId* |
Free routes: /, /health, /openapi.json, /.well-known/x402.
Try it
Not deployed yet. The URL below is the planned address. After launch, an unpaid call returns
402 with the terms in the price table.curl -i "https://toolmint-clinicaltrials.toolmint.workers.dev/trials?condition=breast%20cancer&status=RECRUITING&phase=2,3&location=Houston,%20TX"
Inputs
| Name | Rule |
|---|---|
condition, intervention, term, location, sponsor, lat+lon | At least one is required |
status, phase | Comma lists; phase also accepts 1,2,3,4 |
lat, lon, radiusMi | lat -90..90, lon -180..180, radius 1-500 miles (default 50) |
pageSize, pageToken | 1-50 (default 10); pageToken = nextPageToken from the previous page |
What you get
- Per study: status, phase, study type, sponsor, collaborators, enrollment, key dates, sites (facility, city, state, country), keywords, interventions, primary outcomes, uiUrl
- Eligibility split into inclusion/exclusion lists (40 items × 500 chars max, criteriaTruncated); without headings, raw criteriaText (≤ 2,000 chars) and criteriaParsed: false
- Caps: summary excerpt 600 chars, 25 sites (locationsTruncated), 20 keywords, 20 interventions, 5 primary outcomes
- provenance (URL, API version, dataTimestamp, fetchedAt, sha256), terms
- Personal contact data (names, phones, emails of contacts and officials) is never returned.
Sources and terms
- ClinicalTrials.gov API v2 (US National Library of Medicine), public, no key. One call per paid request plus one /version call per hour per isolate; results cached 10 minutes.
Limits (read before relying on it)
- Not medical advice and not an eligibility decision; every response says so.
- Records are submitted by sponsors and may be out of date. No NLM/NIH endorsement.
Example
GET /trials?condition=asthma&status=RECRUITING&pageSize=5
Errors are not charged
Payment settles only on a successful answer. These responses are never settled:
| Status | Meaning (from the OpenAPI) | Charged? |
|---|---|---|
400 | Bad parameters (not charged) | No |
404 | NCT number not on ClinicalTrials.gov (not charged) | No |
502 | Upstream ClinicalTrials.gov error (not charged) | No |