Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

National Institutes of Health (NIH) Studies API

Related to clinical trial studies

National Institutes of Health (NIH) Studies API is one of 15 APIs that National Institutes of Health (NIH) publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Studies. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 5 paths, and defines 144 schemas. It is described by OpenAPI 3.0.3, at version 2.0.5.

Requests are made against a single base URL, https://clinicaltrials.gov/api/v2.

5 operations 5 paths 144 schemas 5 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
2.0.5
Base URL
https://eutils.ncbi.nlm.nih.gov/entrez/eutils/
Resource Areas
1

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 5 GET. Each is listed below with its method, path, parameters, and response codes.

Studies 5

Related to clinical trial studies

GET
/studies
Studies
listStudies 29 params → 200400
GET
/studies/{nctId}
Single Study
fetchStudy 4 params → 200301400404
GET
/studies/metadata
Data Model Fields
studiesMetadata 2 params → 200400
GET
/studies/search-areas
Search Areas
searchAreas → 200400
GET
/studies/enums
Enums
enums → 200400

Schemas 144

The contract defines 144 schemas that model the data the API accepts and returns. The most detailed are StatusModule (21 properties), MeasureAnalysis (21 properties), OutcomeMeasure (17 properties), FieldNode (16 properties). Each schema is shown below with its type and property counts.

OrgStudyIdType
string
IpdSharingInfoType
string
ArmsInterventionsModule
object
2 properties
EventStats
object
4 properties
EnumInfo
object
3 properties 3 required
GeoPoint
object
2 properties 2 required
SponsorCollaboratorsModule
object
3 properties
DesignInfo
object
7 properties
CertainAgreement
object
4 properties
StudyList
array
study field values of type markup are in markdown format.
Retraction
object
2 properties
BrowseLeafRelevance
string
InterventionalAssignment
string
MiscInfoModule
object
3 properties
BioSpecRetention
string
OutcomesModule
object
3 properties
Intervention
object
5 properties
ExpandedAccessStatus
string
ArmGroup
object
4 properties
DesignModule
object
9 properties
Sponsor
object
2 properties
AgreementRestrictionType
string
UnpostedEventType
string
WhoMasked
string
BioSpec
object
2 properties
OrgStudyIdInfo
object
3 properties
SeeAlsoLink
object
2 properties
ResultsSection
object
5 properties
SecondaryIdType
string
FlowMilestone
object
3 properties
Status
string
FlowStats
object
4 properties
DesignMasking
string
AnnotationModule
object
2 properties
MeasureParam
string
AdverseEvent
object
6 properties
EnrollmentType
string
OutcomeMeasure
object
17 properties
errorMessage
string
A text message describing an error
ReferenceType
string
GeoName
string
State/province or city name
BrowseLeaf
object
4 properties
PointOfContact
object
5 properties
SubmissionTracking
object
3 properties
InterventionType
string
EligibilityModule
object
10 properties
RecruitmentStatus
string
SamplingMethod
string
nct
string
NCT number
UnpostedEvent
object
3 properties
EventGroup
object
9 properties
StudyType
string
LargeDoc
object
9 properties
DesignTimePerspective
string
ProtocolSection
object
13 properties
IpdSharingStatementModule
object
6 properties
StudiesZip
string
Study objects as files in zip archive
NonInferiorityType
string
EnrollmentInfo
object
2 properties
ContactRole
string
ParticipantFlowModule
object
5 properties
PartialDateStruct
object
2 properties
DenomCount
object
2 properties
MeasureClass
object
3 properties
EnumInfoList
array
ReferencesModule
object
3 properties
AvailIpd
object
4 properties
ViolationEventType
string
FlowPeriod
object
3 properties
AnalysisDispersionType
string
ExpandedAccessInfo
object
3 properties
PartialDate
string
Date in yyyy, yyyy-MM, or yyyy-MM-dd format
ReportingStatus
string
UnpostedAnnotation
object
2 properties
ObservationalModel
string
FlowGroup
object
3 properties
SecondaryIdInfo
object
4 properties
AdverseEventsModule
object
7 properties
BaselineCharacteristicsModule
object
5 properties
StudiesCsv
string
Study objects in csv file
Mesh
object
2 properties
Location
object
8 properties
BaselineMeasure
object
10 properties
OversightModule
object
7 properties
DocumentSection
object
1 property
Outcome
object
3 properties
IpdSharing
string
ViolationEvent
object
6 properties
EnumItem
object
3 properties 2 required
FirstMcpInfo
object
1 property
AgencyClass
string
ResponsiblePartyType
string
BrowseModule
object
4 properties
StudyFhir
object
Study in FHIR JSON format
WebLink
object
2 properties 2 required
Study
object
6 properties
AnnotationSection
object
1 property
Contact
object
5 properties
Denom
object
2 properties
Official
object
3 properties
MoreInfoModule
object
3 properties
DesignAllocation
string
MaskingBlock
object
3 properties
PrimaryPurpose
string
ResponsibleParty
object
6 properties
EventAssessment
string
FieldNodeList
array
SearchPart
object
5 properties 5 required
Organization
object
2 properties
DescriptionModule
object
2 properties
OfficialRole
string
DropWithdraw
object
3 properties
ConditionsModule
object
2 properties
LargeDocumentModule
object
2 properties
IdentificationModule
object
8 properties
ConfidenceIntervalNumSides
string
LimitationsAndCaveats
object
1 property
Reference
object
4 properties
MeasureCategory
object
2 properties
Measurement
object
6 properties
ExpandedAccessTypes
object
3 properties
SubmissionInfo
object
5 properties
SearchDocumentList
array
OutcomeMeasureType
string
FieldNode
object
16 properties 4 required
DateStruct
object
2 properties
DerivedSection
object
3 properties
ContactsLocationsModule
object
3 properties
DateTimeMinutes
string
Date and time in yyyy-MM-dd'T'HH:mm format
OutcomeMeasuresModule
object
1 property
PagedStudies
object
3 properties 1 required
BrowseBranch
object
2 properties
StandardAge
string
MeasureAnalysis
object
21 properties
MeasureDispersionType
string
SearchArea
object
4 properties 2 required
SearchDocument
object
2 properties 2 required
Sex
string
StatusModule
object
21 properties
ArmGroupType
string
MeasureGroup
object
3 properties
ViolationAnnotation
object
1 property
DateType
string
Phase
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

nih-studies-api-openapi.yml Raw ↑

Other APIs National Institutes of Health (NIH) publishes across the network.

NCBI E-utilities (Entrez Programming Utilities)
PubChem Power User Gateway (PUG REST)
NIH RePORTER API
NCBI BLAST URL API
PubMed Central (PMC) OA API
National Institutes of Health (NIH) BioSample API
National Institutes of Health (NIH) Gene API
National Institutes of Health (NIH) Genome API
National Institutes of Health (NIH) Organelle API
National Institutes of Health (NIH) Prokaryote API
National Institutes of Health (NIH) Stats API
National Institutes of Health (NIH) Taxonomy API