# 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.

- Status: Coming soon
- Price: $0.01 / call (x402 exact, USDC on Base eip155:8453, payTo 0xfbF7413bcB3a604936775C96FDbe0b0C9c9E37F5)
- Planned URL: https://toolmint-clinicaltrials.toolmint.workers.dev
- OpenAPI: https://toolmint.toolmint.workers.dev/tools/clinicaltrials-json/openapi.json

## Routes

- `GET /trials` $0.01: Search studies by condition / intervention / location / status / phase
- `GET /trials/{nctId}` $0.01: One study by NCT number

## 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
```