/clinicaltrials/studies

POST /api/clinicaltrials/studies

Price: 1 credit

Get a clinical study record by its NCT identifier

How to use it

Get the full ClinicalTrials.gov record for a clinical study by NCT id (e.g. 'NCT00841061'). Returns identification (titles, acronym, organization, secondary ids), recruitment status and key dates, sponsors and collaborators, oversight, brief and detailed descriptions, conditions and keywords, study design (type, patient-registry flag, phases, allocation, masking, intervention model, biospecimen retention, enrollment), arm groups and interventions, primary and secondary outcomes, eligibility criteria, central contacts, overall officials and study locations with geo-coordinates, references, MeSH terms, individual-participant-data (IPD) sharing statement, downloadable study documents (protocol, statistical analysis plan, informed consent), and — when posted — a summary of reported results (participant flow, outcome measures, adverse-event groups).

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• nct_id string required — Study NCT identifier (also accepts a clinicaltrials.gov study URL) (examples: "NCT00841061", "NCT00935818"; minLength: 1)

Response

• @type string (default: "ClinicaltrialsStudy")
• id string required
• org_study_id string nullable
• secondary_ids array (default: [])
  • @type string (default: "ClinicaltrialsSecondaryId")
  • id string required
  • type string nullable
  • domain string nullable
• brief_title string nullable
• official_title string nullable
• acronym string nullable
• organization string nullable
• organization_class string nullable
• overall_status string nullable
• last_known_status string nullable
• status_verified_date string nullable
• why_stopped string nullable
• start_date string nullable
• primary_completion_date string nullable
• completion_date string nullable
• study_first_post_date string nullable
• last_update_post_date string nullable
• results_first_post_date string nullable
• has_expanded_access boolean nullable
• lead_sponsor object nullable
  • @type string (default: "ClinicaltrialsSponsor")
  • name string required
  • sponsor_class string nullable
• collaborators array (default: [])
  • @type string (default: "ClinicaltrialsSponsor")
  • name string required
  • sponsor_class string nullable
• responsible_party_type string nullable
• responsible_party_name string nullable
• responsible_party_title string nullable
• responsible_party_affiliation string nullable
• oversight_has_dmc boolean nullable
• is_fda_regulated_drug boolean nullable
• is_fda_regulated_device boolean nullable
• is_us_export boolean nullable
• brief_summary string nullable
• detailed_description string nullable
• conditions array (default: [])
• keywords array (default: [])
• study_type string nullable
• is_patient_registry boolean nullable
• phases array (default: [])
• allocation string nullable
• intervention_model string nullable
• intervention_model_description string nullable
• primary_purpose string nullable
• masking string nullable
• observational_model string nullable
• time_perspective string nullable
• bio_spec_retention string nullable
• bio_spec_description string nullable
• enrollment_count integer nullable
• enrollment_type string nullable
• arm_groups array (default: [])
  • @type string (default: "ClinicaltrialsArmGroup")
  • label string required
  • type string nullable
  • description string nullable
  • intervention_names array (default: [])
• interventions array (default: [])
  • @type string (default: "ClinicaltrialsIntervention")
  • type string nullable
  • name string required
  • description string nullable
  • arm_group_labels array (default: [])
  • other_names array (default: [])
• primary_outcomes array (default: [])
  • @type string (default: "ClinicaltrialsOutcome")
  • measure string required
  • description string nullable
  • time_frame string nullable
• secondary_outcomes array (default: [])
  • @type string (default: "ClinicaltrialsOutcome")
  • measure string required
  • description string nullable
  • time_frame string nullable
• eligibility_criteria string nullable
• healthy_volunteers boolean nullable
• sex string nullable
• is_gender_based boolean nullable
• gender_description string nullable
• minimum_age string nullable
• maximum_age string nullable
• std_ages array (default: [])
• study_population string nullable
• sampling_method string nullable
• central_contacts array (default: [])
  • @type string (default: "ClinicaltrialsContact")
  • name string nullable
  • role string nullable
  • phone string nullable
  • email string nullable
  • affiliation string nullable
• overall_officials array (default: [])
  • @type string (default: "ClinicaltrialsContact")
  • name string nullable
  • role string nullable
  • phone string nullable
  • email string nullable
  • affiliation string nullable
• locations array (default: [])
  • @type string (default: "ClinicaltrialsLocation")
  • facility string nullable
  • status string nullable
  • city string nullable
  • state string nullable
  • zip string nullable
  • country string nullable
  • lat number nullable
  • lon number nullable
  • contacts array (default: [])
    • @type string (default: "ClinicaltrialsContact")
    • name string nullable
    • role string nullable
    • phone string nullable
    • email string nullable
    • affiliation string nullable
• references array (default: [])
  • @type string (default: "ClinicaltrialsReference")
  • pmid string nullable
  • type string nullable
  • citation string nullable
• condition_meshes array (default: [])
  • @type string (default: "ClinicaltrialsMeshTerm")
  • id string required
  • term string required
• intervention_meshes array (default: [])
  • @type string (default: "ClinicaltrialsMeshTerm")
  • id string required
  • term string required
• ipd_sharing string nullable
• ipd_sharing_description string nullable
• ipd_sharing_info_types array (default: [])
• ipd_sharing_time_frame string nullable
• ipd_sharing_access_criteria string nullable
• ipd_sharing_url string nullable
• documents array (default: [])
  • @type string (default: "ClinicaltrialsDocument")
  • type_abbrev string nullable
  • label string nullable
  • date string nullable
  • upload_date string nullable
  • size integer nullable
  • has_protocol boolean nullable
  • has_sap boolean nullable
  • has_icf boolean nullable
  • filename string nullable
  • url string nullable
• has_results boolean (default: false)
• results_summary object nullable
  • @type string (default: "ClinicaltrialsResultsSummary")
  • recruitment_details string nullable
  • pre_assignment_details string nullable
  • population_description string nullable
  • outcome_measure_titles array (default: [])
  • adverse_event_frequency_threshold string nullable
  • adverse_event_groups array (default: [])
    • @type string (default: "ClinicaltrialsAdverseEventGroup")
    • serious_num_affected integer nullable
    • serious_num_at_risk integer nullable
    • other_num_affected integer nullable
    • other_num_at_risk integer nullable
  • point_of_contact object nullable
    • @type string (default: "ClinicaltrialsContact")
    • name string nullable
    • role string nullable
    • phone string nullable
    • email string nullable
    • affiliation string nullable
• web_url string (default: "")

Errors

• 422 — The request body did not validate Check the fields against this schema. A URN with the wrong prefix is the most common cause.
• 408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.
• 412 — Study not found Retrying will not help: either the entity does not exist, or the input points at a different one.
• 429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.
• 500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.
• 529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.
• X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.
• X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.
• X-Retry-After — Seconds to wait before retrying. Present only on 429.