> ## Documentation Index > Fetch the complete documentation index at: https://docs.pav.bio/llms.txt > Use this file to discover all available pages before exploring further. # Get a trial > One ClinicalTrials.gov trial with its linked programs and companies. ## OpenAPI ````yaml /openapi.json get /v1/trials/{nct_id} openapi: 3.1.0 info: title: Pav Enterprise API description: >- Read-only API over Pav's biopharma data: programs, drugs, companies, trials, deals, patents, FDA records and changes. Send `Authorization: Bearer `. Lists return `{data, next_cursor, total}`; errors return `{error: {code, message, request_id}}`. Parameter rules: [Conventions](https://docs.pav.bio/conventions). version: 2.0.0 servers: - url: https://api.pav.bio description: Production security: [] tags: - name: search description: Find the id of a company, drug, program, target or indication. x-group: Search - name: programs description: 'Drug programs: one drug in one indication at one company.' x-group: Programs - name: drugs description: >- One drug product across every company that develops it, under all its names, with its programs. x-group: Drugs - name: companies description: Biopharma companies, their owners and their trials. x-group: Companies - name: trials description: ClinicalTrials.gov trials linked to programs and companies. x-group: Trials - name: deals description: M&A, licensing and collaboration deals with terms and sources. x-group: Deals - name: patents description: US patent families with owners, members and term. x-group: Patents - name: fda description: FDA records, one endpoint per record type. x-group: FDA - name: changes description: Program and trial changes, newest first. x-group: Changes - name: stats description: Dataset counts. x-group: Stats paths: /v1/trials/{nct_id}: get: tags: - trials summary: Get a trial description: One ClinicalTrials.gov trial with its linked programs and companies. operationId: get_trial parameters: - name: nct_id in: path required: true schema: type: string description: ClinicalTrials.gov NCT identifier. examples: - NCT04368728 title: Nct Id description: ClinicalTrials.gov NCT identifier. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Trial' '400': description: Invalid parameter (`validation_error`). content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '401': description: Missing or invalid API key (`unauthorized`). content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '404': description: Unknown id or route (`not_found`). content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '429': description: Rate limit exceeded (`rate_limited`); honor `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' security: - EnterpriseApiKey: [] components: schemas: Trial: properties: nct_id: type: string title: Nct Id description: ClinicalTrials.gov registry identifier (NCT number). examples: - NCT04368728 nct_url: anyOf: - type: string - type: 'null' title: Nct Url description: ClinicalTrials.gov URL for the trial record. examples: - https://clinicaltrials.gov/study/NCT04368728 title: anyOf: - type: string - type: 'null' title: Title description: Official or brief title of the trial. examples: - A Study of a Vaccine to Prevent COVID-19 phase: anyOf: - type: string - type: 'null' title: Phase description: Trial phase as reported by ClinicalTrials.gov. examples: - Phase 3 status: anyOf: - type: string - type: 'null' title: Status description: Overall recruitment/operational status of the trial. examples: - Completed sponsor: anyOf: - type: string - type: 'null' title: Sponsor description: Lead sponsor of the trial. examples: - Pfizer study_type: anyOf: - type: string - type: 'null' title: Study Type description: Study type (e.g. Interventional, Observational). examples: - Interventional conditions: items: type: string type: array title: Conditions description: Conditions/indications studied in the trial. examples: - - COVID-19 - SARS-CoV-2 Infection enrollment_count: anyOf: - type: integer - type: 'null' title: Enrollment Count description: Planned or actual participant enrollment. examples: - 43998 program_count: anyOf: - type: integer - type: 'null' title: Program Count description: Number of Pav programs linked to this trial. examples: - 2 company_short_names: items: type: string type: array title: Company Short Names description: >- Slugs of companies whose Pav programs are linked to this trial. For sponsor-based links as well, see `company_ids` and `sponsors`. examples: - - pfizer - biontech lead_sponsor: anyOf: - $ref: '#/components/schemas/SponsorRef' - type: 'null' description: >- Lead sponsor as recorded on ClinicalTrials.gov. Null when the registry record names no sponsor organization (e.g. some pre-2016 records). collaborators: items: $ref: '#/components/schemas/SponsorRef' type: array title: Collaborators description: Collaborator sponsors as recorded on ClinicalTrials.gov. sponsors: items: $ref: '#/components/schemas/SponsorRef' type: array title: Sponsors description: All sponsors (lead, collaborators, owners), lead sponsor first. company_ids: items: type: integer type: array title: Company Ids description: Company ids linked as sponsor, collaborator or through a program. examples: - - 127 - 506 programs: items: $ref: '#/components/schemas/TrialProgram' type: array title: Programs description: Pav programs linked to this trial. start_date: anyOf: - type: string - type: 'null' title: Start Date description: Trial start date as reported by ClinicalTrials.gov. examples: - '2020-04-29' last_update_post_date: anyOf: - type: string - type: 'null' title: Last Update Post Date description: Date the trial record was last updated on ClinicalTrials.gov. examples: - '2023-08-15' primary_completion_date: anyOf: - type: string - type: 'null' title: Primary Completion Date description: Primary completion date (actual or anticipated). examples: - '2012-06-01' completion_date: anyOf: - type: string - type: 'null' title: Completion Date description: Study completion date as reported by ClinicalTrials.gov. examples: - '2013-03-01' results_first_post_date: anyOf: - type: string - type: 'null' title: Results First Post Date description: >- Date results were first posted on ClinicalTrials.gov. Null until the trial has posted results. examples: - '2016-08-04' why_stopped: anyOf: - type: string - type: 'null' title: Why Stopped description: >- Free-text reason the trial stopped early, as reported by ClinicalTrials.gov. Null for trials that did not stop early. examples: - Slow enrollment primary_outcomes: items: $ref: '#/components/schemas/PrimaryOutcome' type: array title: Primary Outcomes description: >- The trial's primary outcome measures (primary endpoints) as reported by ClinicalTrials.gov. type: object required: - nct_id title: Trial ErrorEnvelope: properties: error: $ref: '#/components/schemas/ErrorBody' description: Error detail. Present only on 4xx/5xx responses. required: - error title: ErrorEnvelope type: object SponsorRef: properties: name: type: string title: Name description: Sponsor organization name exactly as recorded on ClinicalTrials.gov. examples: - BioNTech SE role: type: string title: Role description: >- Sponsor role on the trial: `lead_sponsor`, `collaborator`, or `owner`. examples: - lead_sponsor company_id: anyOf: - type: integer - type: 'null' title: Company Id description: >- Pav company identifier this sponsor is linked to. Null when the sponsor is not a tracked company. examples: - 127 short_name: anyOf: - type: string - type: 'null' title: Short Name description: Slug of the Pav company this organization is linked to, when linked. examples: - biontech type: object required: - name - role title: SponsorRef TrialProgram: properties: program_id: type: integer title: Program Id description: Durable Pav program identifier linked to this trial. examples: - 1027 short_name: type: string title: Short Name description: Slug of the company that owns the linked program. examples: - biontech company_id: type: integer title: Company Id description: Pav company identifier that owns the linked program. examples: - 127 drug: anyOf: - type: string - type: 'null' title: Drug description: Drug/asset name of the linked program. examples: - BNT162b2 indication: anyOf: - type: string - type: 'null' title: Indication description: Indication the linked program targets. examples: - COVID-19 type: object required: - program_id - short_name - company_id title: TrialProgram PrimaryOutcome: properties: measure: anyOf: - type: string - type: 'null' title: Measure description: The trial's primary endpoint measure (what is being assessed). examples: - Progression-Free Survival (PFS) time_frame: anyOf: - type: string - type: 'null' title: Time Frame description: Time frame over which the primary outcome is measured. examples: - Year 3 description: anyOf: - type: string - type: 'null' title: Description description: Free-text description/definition of the primary outcome. examples: - >- Patients are considered a failure if they die, progress, or relapse. type: object title: PrimaryOutcome ErrorBody: properties: code: description: >- Stable, machine-readable error code (e.g. `unauthorized`, `not_found`, `validation_error`, `error`). examples: - not_found title: Code type: string message: description: Human-readable explanation of the error. examples: - program 999999 not found title: Message type: string request_id: anyOf: - type: string - type: 'null' default: null description: >- Correlation id echoed in the `X-Request-ID` response header. Quote it when contacting Pav support about a failed request. examples: - 3f2b9c1d8a7e4f6b9c0d1e2f3a4b5c6d title: Request Id required: - code - message title: ErrorBody type: object securitySchemes: EnterpriseApiKey: type: http description: >- Use a personal or organization Pav API key from Pav developer settings. Send it as Authorization: Bearer . scheme: bearer bearerFormat: Pav API key ````