ToolMint

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

RoutePriceWhat it doesParameters (* required)
GET /trials$0.01Search studies by condition / intervention / location / status / phasecondition, intervention, term, location, sponsor, status, phase, lat, lon, radiusMi, pageSize, pageToken
GET /trials/{nctId}$0.01One study by NCT numbernctId*

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

NameRule
condition, intervention, term, location, sponsor, lat+lonAt least one is required
status, phaseComma lists; phase also accepts 1,2,3,4
lat, lon, radiusMilat -90..90, lon -180..180, radius 1-500 miles (default 50)
pageSize, pageToken1-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:

StatusMeaning (from the OpenAPI)Charged?
400Bad parameters (not charged)No
404NCT number not on ClinicalTrials.gov (not charged)No
502Upstream ClinicalTrials.gov error (not charged)No