Single Study

Returns data of a single study.

byClinicalTrials.gov

168calls

N/Alatency

Discover -> Inspect -> Call

Call setup

Tool IDclinicaltrials_gov.studies.retrieve.v1.31d90b9a

Request parametersJSON

Before this Call

1 credit / call

The final charge is settled from actual provider usage and will appear in Usage.

Field reference

nctIdstringRequired

NCT Number of a study. If found in [NCTIdAlias](data-api/about-api/study-data-structure#NCTIdAlias) field, 301 HTTP redirect to the actual study will be returned.

formatstringOptional

Must be one of the following: * `csv`- return CSV table; available fields are listed on [CSV Download](/data-api/about-api/csv-download) * `json`- return JSON object; format of `markup` fields depends on `markupFormat` parameter * `json.zip`- put JSON object into a .json file and download it as zip archive; field values of type `markup` are in [markdown](https://spec.commonmark.org/0.28/) format * `fhir.json` - return FHIR JSON; fields are not customizable; see [Access Data in FHIR](/data-api/fhir) * `ris`- return RIS record; available tags are listed on [RIS Download](/data-api/about-api/ris-download)

markupFormatstringOptional

Format of `markup` type fields: * `markdown`- [markdown](https://spec.commonmark.org/0.28/) format * `legacy`- compatible with classic PRS Applicable only to `json` format.

fieldsarrayOptional

If specified, must be non-empty comma- or pipe-separated list of fields to return. If unspecified, all fields will be returned. Order of the fields does not matter. For `csv` format, specify list of columns. The column names are available on [CSV Download](/data-api/about-api/csv-download). For `json` and `json.zip` formats, every list item is either area name, piece name, or field name. If a piece or a field is a branch node, all descendant fields will be included. All area names are available on [Search Areas](/data-api/about-api/search-areas), the piece and field names - on [Data Structure](/data-api/about-api/study-data-structure) and also can be retrieved at `/studies/metadata` endpoint. For `fhir.json` format, all available fields are returned and this parameter must be unspecified. For `ris` format, specify list of tags. The tag names are available on [RIS Download](/data-api/about-api/ris-download).