# ClinicalTrials.gov

> Search the U.S. National Library of Medicine's registry of more than 600,000 clinical trials and studies worldwide by condition, treatment, place, sponsor, status, phase and date, read any study in full, and start a workflow when a matching study is posted or updated. No account or API key required.

App · 9 actions. Web page: https://docs.lodol.com/docs/integrations/clinicaltrials-gov

## Actions

### Get data version

Find out when ClinicalTrials.gov last refreshed its data (it does so once a day) and which version of its API is running.

**Inputs**: None.

**Outputs**

- `api_version` (text): The API's version, e.g. 2.0.5
- `data_timestamp` (text): When the data was last refreshed, in UTC (YYYY-MM-DDTHH:MM:SS)
- `summary` (text): One line: the API version and when the data was refreshed

**Example output**

```json
{
  "api_version": "2.0.5",
  "data_timestamp": "2026-10-19T09:00:04",
  "summary": "API 2.0.5; data refreshed 2026-10-19T09:00:04 UTC"
}
```

### Get field value statistics

See how the whole registry fills in chosen fields: the commonest values and how many studies have each (e.g. the top sponsors or how many studies are in each phase), how many studies leave the field empty, and the range of numbers and dates.

**Inputs**

- Fields (`fields`, list, required): The fields to count, e.g. Phase or LeadSponsorName.

**Outputs**

- `count` (number): How many came back
- `fields` (list): Each field's statistics

**Example output**

```json
{
  "count": 1,
  "fields": [
    {
      "average": null,
      "date_formats": [],
      "false_count": null,
      "longest_value": null,
      "maximum": null,
      "minimum": null,
      "missing_studies_count": 144067,
      "path": "protocolSection.designModule.phases",
      "piece": "Phase",
      "top_values": [
        {
          "studies_count": 239092,
          "value": "NA"
        },
        {
          "studies_count": 90608,
          "value": "PHASE2"
        }
      ],
      "true_count": null,
      "type": "ENUM",
      "unique_values_count": 6
    }
  ]
}
```

### Get list field size statistics

See how many items list fields hold across the registry, e.g. how many conditions, sites or phases studies have: the shortest and longest lists and how many studies have each length. Leave the fields empty for every list field.

**Inputs**

- List fields (`fields`, list): The list fields, e.g. Condition or Location. Leave empty for all.

**Outputs**

- `count` (number): How many came back
- `fields` (list): Each list field's statistics

**Example output**

```json
{
  "count": 1,
  "fields": [
    {
      "maximum_size": 2,
      "minimum_size": 1,
      "path": "protocolSection.designModule.phases",
      "piece": "Phase",
      "top_sizes": [
        {
          "size": 1,
          "studies_count": 438693
        },
        {
          "size": 2,
          "studies_count": 24769
        }
      ],
      "unique_sizes_count": 2
    }
  ]
}
```

### Get study

Get everything ClinicalTrials.gov records about one study from its NCT number: titles, status and dates, sponsor and collaborators, design, groups and treatments, outcome measures, eligibility criteria, contacts, sites (50 unless you ask for more, or only those in one country), publications and whether results are posted, with a link to them. You can paste the study's page address instead of its number.

**Inputs**

- NCT number (`nct_id`, text, required): The study's NCT number, e.g. NCT04368728, from 'Search studies' or the study's page address.
- Sites to list (`max_locations`, number): How many of its sites to list, 0 to 5,000. Defaults to 50; the total is always in 'location_count'. From 0 to 5000.
- Sites in country (`site_country`, text): Only list sites in this country, e.g. Germany.

**Outputs**

- `study` (object): The study

**Example output**

```json
{
  "study": {
    "acronym": null,
    "arms": [
      {
        "description": null,
        "interventions": [
          "Biological: BNT162b2"
        ],
        "label": "30 \u00b5g dose, 18-55 years of age (2 doses)",
        "type": "EXPERIMENTAL"
      }
    ],
    "brief_summary": "This is a Phase 1/2/3, randomized, placebo-controlled study.",
    "brief_title": "Study to Describe the Safety, Tolerability, Immunogenicity, and Efficacy of RNA Vaccine Candidates Against COVID-19 in Healthy Individuals",
    "central_contacts": [],
    "collaborators": [
      "Pfizer"
    ],
    "completion_date": "2023-02-10",
    "completion_date_type": "ACTUAL",
    "condition_mesh_terms": [
      "COVID-19",
      "Coronavirus Infections"
    ],
    "conditions": [
      "SARS-CoV-2 Infection",
      "COVID-19"
    ],
    "countries": [
      "United States"
    ],
    "design": {
      "allocation": "RANDOMIZED",
      "intervention_model": "PARALLEL",
      "masking": "TRIPLE",
      "observational_model": null,
      "primary_purpose": "PREVENTION",
      "time_perspective": null,
      "who_masked": [
        "PARTICIPANT",
        "CARE_PROVIDER",
        "INVESTIGATOR"
      ]
    },
    "detailed_description": null,
    "eligibility": {
      "age_groups": [
        "CHILD",
        "ADULT",
        "OLDER_ADULT"
      ],
      "criteria": "Inclusion Criteria:\n\n* Healthy participants",
      "healthy_volunteers": true,
      "maximum_age": "85 Years",
      "minimum_age": "12 Years",
      "sampling_method": null,
      "sex": "ALL",
      "study_population": null
    },
    "enrollment": 46969,
    "enrollment_type": "ACTUAL",
    "first_posted": "2020-04-30",
    "first_submitted": "2020-04-27",
    "has_results": true,
    "intervention_details": [
      {
        "arms": [
          "30 \u00b5g dose, 18-55 years of age (2 doses)"
        ],
        "description": "Intramuscular injection",
        "name": "BNT162b2",
        "other_names": [],
        "type": "BIOLOGICAL"
      }
    ],
    "intervention_mesh_terms": [
      "BNT162 Vaccine"
    ],
    "interventions": [
      "Biological: BNT162b1",
      "Biological: BNT162b2"
    ],
    "ipd_sharing": "NO",
    "keywords": [
      "COVID-19",
      "Vaccine"
    ],
    "last_known_status": null,
    "last_updated": "2026-03-25",
    "location_count": 1,
    "locations": [
      {
        "city": "Athens",
        "country": "United States",
        "facility": "North Alabama Research Center, LLC",
        "latitude": 34.80243,
        "longitude": -86.97219,
        "state": "Alabama",
        "status": null,
        "zip": "35611"
      }
    ],
    "nct_id": "NCT04368728",
    "official_title": "A PHASE 1/2/3, PLACEBO-CONTROLLED, RANDOMIZED, OBSERVER-BLIND, DOSE-FINDING STUDY TO EVALUATE THE SAFETY, TOLERABILITY, IMMUNOGENICITY, AND EFFICACY OF SARS-COV-2 RNA VACCINE CANDIDATES AGAINST COVID-19 IN HEALTHY INDIVIDUALS",
    "org_study_id": "C4591001",
    "overall_officials": [
      {
        "affiliation": "Pfizer",
        "name": "Pfizer CT.gov Call Center",
        "role": "STUDY_DIRECTOR"
      }
    ],
    "overall_status": "COMPLETED",
    "oversight": {
      "fda_regulated_device": false,
      "fda_regulated_drug": true,
      "has_dmc": true
    },
    "phase_label": "Phase 2/Phase 3",
    "phases": [
      "PHASE2",
      "PHASE3"
    ],
    "primary_completion_date": "2023-02-10",
    "primary_completion_date_type": "ACTUAL",
    "primary_outcomes": [
      {
        "description": "Redness, swelling and pain at the injection site.",
        "measure": "Percentage of Participants With Local Reactions",
        "time_frame": "For 7 days after dose 1"
      }
    ],
    "references": [
      {
        "citation": "Polack FP, et al. Safety and Efficacy of the BNT162b2 mRNA Covid-19 Vaccine. N Engl J Med. 2020.",
        "pmid": "33301246",
        "type": "RESULT"
      }
    ],
    "responsible_party": {
      "investigator_affiliation": null,
      "investigator_name": null,
      "investigator_title": null,
      "type": "SPONSOR"
    },
    "results_first_posted": "2026-03-25",
    "results_url": "https://clinicaltrials.gov/study/NCT04368728?tab=results",
    "secondary_ids": [
      {
        "domain": null,
        "id": "2020-002641-42",
        "type": "EUDRACT_NUMBER"
      }
    ],
    "secondary_outcomes": [],
    "see_also_links": [],
    "sponsor": "BioNTech SE",
    "sponsor_type": "INDUSTRY",
    "start_date": "2020-04-29",
    "start_date_type": "ACTUAL",
    "status_label": "Completed",
    "status_verified": "2026-03",
    "study_type": "INTERVENTIONAL",
    "summary": "NCT04368728: Study to Describe the Safety, Tolerability, Immunogenicity, and Efficacy of RNA Vaccine Candidates Against COVID-19 in Healthy Individuals (Completed, Phase 2/Phase 3)",
    "url": "https://clinicaltrials.gov/study/NCT04368728",
    "why_stopped": null
  }
}
```

### Get study size statistics

See how many studies ClinicalTrials.gov holds and how big their records are: the average and percentiles, how many fall in each size band, and the largest studies. Useful before downloading records in bulk.

**Inputs**: None.

**Outputs**

- `average_size_bytes` (number): The average record size, in bytes
- `largest_studies` (list): The largest studies
- `median_size_bytes` (number): The median record size, in bytes
- `percentiles` (list): Record sizes by percentile
- `ranges` (list): How many studies fall in each size band
- `summary` (text): One line: how many studies, and their average and median size
- `total_studies` (number): How many studies ClinicalTrials.gov holds

**Example output**

```json
{
  "average_size_bytes": 17307,
  "largest_studies": [
    {
      "nct_id": "NCT02723955",
      "size_bytes": 3596767,
      "url": "https://clinicaltrials.gov/study/NCT02723955"
    }
  ],
  "median_size_bytes": 9864,
  "percentiles": [
    {
      "percentile": 50.0,
      "size_bytes": 9864
    }
  ],
  "ranges": [
    {
      "size_range": "0 - 10 kb",
      "studies_count": 319595
    }
  ],
  "summary": "607,529 studies, 16.9 KB on average (9.6 KB median)",
  "total_studies": 607529
}
```

### List coded values

List the fixed codes ClinicalTrials.gov fields use, such as every recruitment status (RECRUITING, COMPLETED...) or phase (PHASE1, PHASE2...), each with the words its website shows for it. Pick one type, or a field that uses it, or leave it empty for all of them.

**Inputs**

- Type (`enum_type`, text): One set of codes, e.g. Status or Phase. Leave empty for all.

**Outputs**

- `count` (number): How many came back
- `enum_types` (list): The sets of codes

**Example output**

```json
{
  "count": 1,
  "enum_types": [
    {
      "fields": [
        "Phase"
      ],
      "type": "Phase",
      "values": [
        {
          "label": "Early Phase 1",
          "value": "EARLY_PHASE1"
        },
        {
          "label": "Phase 1",
          "value": "PHASE1"
        }
      ]
    }
  ]
}
```

### List data model fields

List the fields a ClinicalTrials.gov study record has, with each one's short name (used in searches, sorting and statistics), title, type and description. Narrow them with a word, e.g. 'sponsor'.

**Inputs**

- Containing (`search`, text): Only fields whose name, title or description contains this.
- Include search-only fields (`include_indexed_only`, true/false): Also list fields you can search on but that records do not show.
- Include historic fields (`include_historic_only`, true/false): Also list fields only older record versions have.

**Outputs**

- `count` (number): How many came back
- `fields` (list): The fields

**Example output**

```json
{
  "count": 1,
  "fields": [
    {
      "description": "For a clinical trial of a drug product, the numerical phase.",
      "historic_only": false,
      "indexed_only": false,
      "is_enum": true,
      "is_group": false,
      "is_list": true,
      "path": "protocolSection.designModule.phases",
      "piece": "Phase",
      "source_type": "TEXT",
      "title": "Phase",
      "type": "Phase[]"
    }
  ]
}
```

### List search areas

List the areas ClinicalTrials.gov searches, such as conditions, treatments, locations and sponsors: the fields each looks in, how much a match in each counts towards the best match, and the area name to use in AREA[...] search terms.

**Inputs**: None.

**Outputs**

- `areas` (list): The search areas
- `count` (number): How many came back

**Example output**

```json
{
  "areas": [
    {
      "fields": [
        {
          "field": "Condition",
          "uses_synonyms": true,
          "weight": 0.95
        },
        {
          "field": "BriefTitle",
          "uses_synonyms": true,
          "weight": 0.6
        }
      ],
      "label": "Conditions or disease",
      "name": "ConditionSearch",
      "parameter": "query.cond"
    }
  ],
  "count": 1
}
```

### Search studies

Find clinical trials and other studies on ClinicalTrials.gov by condition, treatment, place, sponsor or any words, narrowed by recruitment status, phase, study type, distance from a point, and when studies started, were first posted or were last updated. Each study comes with its NCT number, title, status, phases, conditions, treatments, sponsor, key dates, countries and a short summary. Up to 1,000 a page; pass the next page token for more.

**Inputs**

- Condition or disease (`condition`, text): The disease or condition studied, e.g. lung cancer or type 2 diabetes.
- Treatment (`intervention`, text): A drug, device, procedure or other treatment, e.g. pembrolizumab.
- Location (`location`, text): A city, state, country or facility name, e.g. Boston or Mayo Clinic.
- Sponsor (`sponsor`, text): The company or organisation running or funding it, e.g. Pfizer.
- Search terms (`query`, text): Any other words to look for anywhere in the study, or an NCT number. Takes ClinicalTrials.gov's search syntax, such as AREA[HasResults]true.
- Recruitment status (`overall_status`, list): Only studies with one of these statuses. Leave empty for any. One or more of: `RECRUITING`, `NOT_YET_RECRUITING` (Not yet recruiting), `ENROLLING_BY_INVITATION` (Enrolling by invitation), `ACTIVE_NOT_RECRUITING` (Active, not recruiting), `COMPLETED`, `SUSPENDED`, `TERMINATED`, `WITHDRAWN`, `UNKNOWN` (Unknown status), `AVAILABLE` (Available (expanded access)), and 4 more.
- Phase (`phases`, list): Only studies in at least one of these phases. Leave empty for any. One or more of: `EARLY_PHASE1` (Early phase 1), `PHASE1` (Phase 1), `PHASE2` (Phase 2), `PHASE3` (Phase 3), `PHASE4` (Phase 4), `NA` (Not applicable).
- Study type (`study_type`, text): Clinical trials, observational studies or expanded access. One of: `INTERVENTIONAL` (Interventional (clinical trial)), `OBSERVATIONAL`, `EXPANDED_ACCESS` (Expanded access).
- Started on or after (`start_date_from`, date): Only studies that started (or will start) on or after this date.
- Started on or before (`start_date_to`, date): Only studies that started (or will start) on or before this date.
- First posted on or after (`first_posted_from`, date): Only studies that first appeared on ClinicalTrials.gov on or after this date.
- First posted on or before (`first_posted_to`, date): Only studies that first appeared on or before this date.
- Updated on or after (`last_updated_from`, date): Only studies whose record was last updated on or after this date.
- Updated on or before (`last_updated_to`, date): Only studies whose record was last updated on or before this date.
- Near latitude (`latitude`, number): With longitude and distance, only studies with a site within that distance of this point, e.g. 40.7128. From -90 to 90.
- Near longitude (`longitude`, number): The point's longitude, e.g. -74.006. From -180 to 180.
- Within distance (`distance`, number): How far from the point a site may be, e.g. 50. From 0.1 to 20000.
- Distance unit (`distance_unit`, text): Miles or kilometres. Defaults to miles. One of: `mi` (Miles), `km` (Kilometres).
- Order (`sort`, text): How to order the studies. Leave empty for ClinicalTrials.gov's default order, which is fastest. One of: `@relevance` (Best match to the search), `LastUpdatePostDate:desc` (Recently updated first), `StudyFirstPostDate:desc` (Recently first posted first), `StartDate:desc` (Latest start date first), `StartDate:asc` (Earliest start date first), `EnrollmentCount:desc` (Most participants first).
- Page size (`page_size`, number): How many studies to return, 1 to 1,000. Defaults to 10. From 1 to 1000.
- Next page token (`page_token`, text): The 'next_page_token' from an earlier search with the same filters, to get the page after it.
- Count all matches (`count_total`, true/false): Also count every matching study, not just this page's.

**Outputs**

- `count` (number): How many came back
- `next_page_token` (text): Pass as 'Next page token' for the next page; empty on the last one
- `studies` (list): The studies on this page
- `total_count` (number): How many studies match in all, when 'Count all matches' is on

**Example output**

```json
{
  "count": 1,
  "next_page_token": "ZVNj7o2Elu8o3lpzWomz5OytmpOQJJxuZvGp",
  "studies": [
    {
      "acronym": null,
      "brief_summary": "The purpose of this platform study is to evaluate the safety, tolerability, pharmacokinetics (PK), and preliminary antitumor activity of RAS(ON) inhibitors.",
      "brief_title": "Study of RAS(ON) Inhibitors in Patients With Advanced RAS-mutated NSCLC",
      "completion_date": "2028-12",
      "conditions": [
        "Non-Small Cell Lung Cancer, NSCLC"
      ],
      "countries": [
        "United States",
        "Australia",
        "France"
      ],
      "enrollment": 616,
      "first_posted": "2023-12-08",
      "has_results": false,
      "interventions": [
        "Drug: RMC-6291",
        "Drug: RMC-6236",
        "Drug: Pembrolizumab"
      ],
      "last_updated": "2026-10-19",
      "location_count": 98,
      "nct_id": "NCT06162221",
      "overall_status": "RECRUITING",
      "phase_label": "Phase 1/Phase 2",
      "phases": [
        "PHASE1",
        "PHASE2"
      ],
      "primary_completion_date": "2027-06",
      "sponsor": "Revolution Medicines, Inc.",
      "start_date": "2024-01-18",
      "status_label": "Recruiting",
      "study_type": "INTERVENTIONAL",
      "summary": "NCT06162221: Study of RAS(ON) Inhibitors in Patients With Advanced RAS-mutated NSCLC (Recruiting, Phase 1/Phase 2)",
      "url": "https://clinicaltrials.gov/study/NCT06162221"
    }
  ],
  "total_count": 118
}
```
