Skip to main content
U.S. flag

An official website of the United States government

Here’s how you know

Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

This is a preview of updates coming to the Technical Bulletin's website in April 2026. Return to current site.
Read more about the modernization release schedule in this announcement.
Comment via the yellow feedback button in the lower right hand corner of the page. Contact the NLM Help Desk with any questions or concerns.

ClinicalTrials.gov API Version 2.0 Now Available

ClinicalTrials.gov API Version 2.0 Now Available. 2024 Mar-Apr;(457):e2.

March 19, 2024 [posted]

The ClinicalTrials.gov API version 2.0 is now available on the modernized ClinicalTrials.gov website. The API, or application programming interface, is a tool to help researchers and developers access the data in ClinicalTrials.gov study records. This new version differs from the legacy API on the classic ClinicalTrials.gov website in important ways, some of which we highlight below.

The ClinicalTrials.gov API version 2.0 is a REST API and uses the OpenAPI Specification 3.0 to describe its meta information. This approach has the following benefits:

  • Allows the support of third-party OpenAPI 3.0 libraries and applications that rely on the ClinicalTrials.gov API to build customized interfaces and workflows.
  • Aligns with standard expectations for publicly accessible modern APIs.

Specific differences in how data are handled by the new ClinicalTrials.gov API include:

  • Standardizing and changing the data type of certain fields (e.g., Intervention Type) from text to enumurated values, meaning users can choose from a set of values.
  • Standardizing number fields.
  • Using the ISO 8601 format for dates.
  • Using the CommonMark Markdown format for rich-text data.
  • Using JSON as the primary response data.

The benefits of these changes for ClinicalTrials.gov API users include:

  • Reducing the data transformation burden.
  • Reducing the validation burden.
  • Allowing users to more readily predict, consume, and use rich-text data.
  • Meeting users' expectations for data from publicly accessible, modern APIs.

To support users as they transition to the modernized API, we have provided support documentation such as a Migration Guide, which discusses the differences between the classic ClinicalTrials.gov API and the ClinicalTrials.gov API version 2.0. It also covers how legacy endpoints are supported through the modernized API. Additional documentation includes:

  • Study Data Structure.
  • Search Areas.
  • CSV Download.

Beginning in April, users may experience brief disruptions in legacy API services during a series of planned outages. Users are strongly encouraged to migrate to the new API as soon as possible. The classic ClinicalTrials.gov API will be retired in June 2024. For more information on the new ClinicalTrials.gov API, please see About the API on the modernized ClinicalTrials.gov website.


screenshot of API Migration Guide including left-hand navigation menu listing Introduction, Info API Endpoints, Qurey API Endpoints, Other Endpoints, and Study Data Model.
Figure 1: An API Migration Guide is available on the ClinicalTrials.gov website for additional support.


screenshot of the About the API webpage, including the link to the API Migration Guide at the top of the page.
Figure 2: Additional information about the new ClinicalTrials.gov API is available on the modernized ClinicalTrials.gov website.