ClinicalTrials.gov
App · 9 actions
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.
Actions
| Action | What it does |
|---|---|
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |
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_versiontext- The API's version, e.g. 2.0.5
data_timestamptext- When the data was last refreshed, in UTC (YYYY-MM-DDTHH:MM:SS)
summarytext- One line: the API version and when the data was refreshed
Example output
{
"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
fieldslistRequired - The fields to count, e.g. Phase or LeadSponsorName.
Outputs
countnumber- How many came back
fieldslist- Each field's statistics
Example output
{
"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
fieldslist - The list fields, e.g. Condition or Location. Leave empty for all.
Outputs
countnumber- How many came back
fieldslist- Each list field's statistics
Example output
{
"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_idtextRequired - The study's NCT number, e.g. NCT04368728, from 'Search studies' or the study's page address.
- Sites to list
max_locationsnumber - 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_countrytext - Only list sites in this country, e.g. Germany.
Outputs
studyobject- The study
Example output
{
"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_bytesnumber- The average record size, in bytes
largest_studieslist- The largest studies
median_size_bytesnumber- The median record size, in bytes
percentileslist- Record sizes by percentile
rangeslist- How many studies fall in each size band
summarytext- One line: how many studies, and their average and median size
total_studiesnumber- How many studies ClinicalTrials.gov holds
Example output
{
"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_typetext - One set of codes, e.g. Status or Phase. Leave empty for all.
Outputs
countnumber- How many came back
enum_typeslist- The sets of codes
Example output
{
"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
searchtext - Only fields whose name, title or description contains this.
- Include search-only fields
include_indexed_onlytrue/false - Also list fields you can search on but that records do not show.
- Include historic fields
include_historic_onlytrue/false - Also list fields only older record versions have.
Outputs
countnumber- How many came back
fieldslist- The fields
Example output
{
"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
areaslist- The search areas
countnumber- How many came back
Example output
{
"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
conditiontext - The disease or condition studied, e.g. lung cancer or type 2 diabetes.
- Treatment
interventiontext - A drug, device, procedure or other treatment, e.g. pembrolizumab.
- Location
locationtext - A city, state, country or facility name, e.g. Boston or Mayo Clinic.
- Sponsor
sponsortext - The company or organisation running or funding it, e.g. Pfizer.
- Search terms
querytext - 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_statuslist - 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
phaseslist - 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_typetext - Clinical trials, observational studies or expanded access.One of:
INTERVENTIONAL(Interventional (clinical trial)),OBSERVATIONAL,EXPANDED_ACCESS(Expanded access). - Started on or after
start_date_fromdate - Only studies that started (or will start) on or after this date.
- Started on or before
start_date_todate - Only studies that started (or will start) on or before this date.
- First posted on or after
first_posted_fromdate - Only studies that first appeared on ClinicalTrials.gov on or after this date.
- First posted on or before
first_posted_todate - Only studies that first appeared on or before this date.
- Updated on or after
last_updated_fromdate - Only studies whose record was last updated on or after this date.
- Updated on or before
last_updated_todate - Only studies whose record was last updated on or before this date.
- Near latitude
latitudenumber - 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
longitudenumber - The point's longitude, e.g. -74.006.From -180 to 180.
- Within distance
distancenumber - How far from the point a site may be, e.g. 50.From 0.1 to 20000.
- Distance unit
distance_unittext - Miles or kilometres. Defaults to miles.One of:
mi(Miles),km(Kilometres). - Order
sorttext - 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_sizenumber - How many studies to return, 1 to 1,000. Defaults to 10.From 1 to 1000.
- Next page token
page_tokentext - The 'next_page_token' from an earlier search with the same filters, to get the page after it.
- Count all matches
count_totaltrue/false - Also count every matching study, not just this page's.
Outputs
countnumber- How many came back
next_page_tokentext- Pass as 'Next page token' for the next page; empty on the last one
studieslist- The studies on this page
total_countnumber- How many studies match in all, when 'Count all matches' is on
Example output
{
"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
}