---
title: "Search ClinicalTrials.gov"
method: GET
path: "/v1/sources/clinicaltrials/search"
tags: ["ClinicalTrials.gov"]
---

# Search ClinicalTrials.gov

`GET /v1/sources/clinicaltrials/search`

## Request

- Base URL: `https://api.assyro.com`
- URL: `https://api.assyro.com/v1/sources/clinicaltrials/search`
- Auth: none declared

Search the LIVE ClinicalTrials.gov registry (queried now, not an index). Use it to map a trial landscape (who is running what, in which phase, how many), find precedent designs, endpoints, comparators, enrollment sizes and eligibility for an indication or product, or check whether a sponsor has registered or posted results for a study. query, condition, intervention and sponsor are optional; phase, status, studyType, start dates and hasResults narrow the search. Returns up to 10 studies with status, phases, sponsor, enrollment and dates, ranked by relevance when a text criterion is given; without one, or with sort "newest", the most recently updated studies matching the filters come first. Cite each study by its NCT number. Registry entries are submitted by sponsors and are not reviewed by FDA, so treat them as what the sponsor declared, not as regulatory findings. Use read_clinical_trial for the full protocol (arms, outcomes, eligibility, results).

## Query parameters

- `query` string: Free text searched across the whole record, e.g. "semaglutide cardiovascular outcomes".
- `condition` string: Disease or condition, e.g. "obesity", "non-small cell lung cancer".
- `conditions` string[]: Several conditions at once, up to 5: one search per condition, run together, with every other filter applied to each (e.g. tirzepatide in ["heart failure", "sleep apnea", "MASH"]). Use it instead of searching one condition per step.
- `intervention` string: Drug, device, biologic or procedure name, e.g. "tirzepatide". A drug name is also searched under its research codes and INN (the result says which names); give the one name, not a list of its codes.
- `interventions` string[]: Several interventions at once, up to 5: one search per intervention, run together, with every other filter applied to each.
- `sponsor` string: Lead sponsor or collaborator, e.g. "Novo Nordisk".
- `phase` string[]: Keep studies in any of these phases. NA means phase not applicable (e.g. device or behavioural).
- `status` string[]: Keep studies with any of these overall recruitment statuses.
- `studyType` 'INTERVENTIONAL' | 'OBSERVATIONAL' | 'EXPANDED_ACCESS': Keep one study type.
- `startDateFrom` string: Earliest study start date, YYYY-MM-DD.
- `startDateTo` string: Latest study start date, YYYY-MM-DD.
- `hasResults` boolean: true keeps only studies with results posted on ClinicalTrials.gov; false keeps only those without.
- `sort` 'relevance' | 'newest': relevance (default; most recently updated first when no text is given) or newest (most recently updated first, even with text).
- `limit` integer: Number of studies to return (default 8).
- `offset` integer: Skip this many results (for paging), default 0.

## Response `200`

Matching records.

- SearchResponse
  - `version` unknown, required
  - `source` SourceRef, required
    - `id` string, required
    - `label` string, required
    - `authority` string, required
  - `total` integer, nullable, required: Total matches the source reports, when it says.
  - `records` Record[], required
    - `id` string, required: The source's own identifier for the record.
    - `title` string, required
    - `url` string, required: The record's page at the source, to verify it.
    - `authority` string, required: Who published the record.
    - `snippet` string, nullable, required: The part of the record that matched; null where the licence allows only a link.
    - `publishedDate` string, nullable, required
    - `version` string, nullable, required: The edition or revision read.
    - `fields` object, nullable, required: The source's own fields; null where the licence allows only a link.
    - `asOf` string, nullable, required: The day Assyro's copy of the source was read (YYYY-MM-DD).
    - `attribution` string: The attribution the source's licence requires, on sources that require one.
  - `note` string
  - `summary` string[]

## Other responses

- `400`: The request is not valid: an unknown parameter or an argument the source refuses.
- `404`: No such source or record.
- `429`: Rate limited; retry after the Retry-After header.
- `503`: The source cannot answer from Assyro's copy right now.

---

[API](https://skmtc.dev/assyro/apis/assyro-public-data-api.md) - [All operations](https://skmtc.dev/assyro/apis/assyro-public-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/assyro/apis/assyro-public-data-api/revisions/c861290c9f47?raw)