---
type: "firecrawl-provider"
description: "ClinicalTrials.gov study registry via the public v2 REST API: search studies by condition, intervention, sponsor, location, status or Essie expression with page-token pagination; fetch one study record by NCT number; batch-resolve the raw ACTUAL/ESTIMATED start, primary-completion and completion dates for known NCT numbers; autocomplete conditions, interventions, sponsors and facilities; and read registry-wide field value statistics."
use_when: "ClinicalTrials.gov study registry via the public v2 REST API: search studies by condition, intervention, sponsor, location, status or Essie expression with page-token pagination; fetch one study record by NCT number; batch-resolve the raw ACTUAL/ESTIMATED start, primary-completion and completion dates for known NCT numbers; autocomplete conditions, interventions, sponsors and facilities; and read registry-wide field value statistics."
categories: "Public records"
capabilities: 5
credits_per_call: 5
---
# ClinicalTrials.gov on Firecrawl Alexandria

ClinicalTrials.gov study registry via the public v2 REST API: search studies by condition, intervention, sponsor, location, status or Essie expression with page-token pagination; fetch one study record by NCT number; batch-resolve the raw ACTUAL/ESTIMATED start, primary-completion and completion dates for known NCT numbers; autocomplete conditions, interventions, sponsors and facilities; and read registry-wide field value statistics.

- Categories: Public records
- Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records)
- Provider key: `clinicaltrials-gov`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/clinicaltrials-gov)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/clinicaltrials-gov/openapi.json)

## Capabilities

- [Field values](https://firecrawl.dev/alexandria/agents/providers/clinicaltrials-gov/clinical-trials/field_values): Registry-wide value statistics for up to 20 field pieces (GET /api/v2/stats/field/values): for enums and strings the distinct values with study counts, for dates and integers min/max, for booleans true/false counts, plus how many studies lack the field. Use it to learn the exact enum values (OverallStatus, Phase, StudyType, DateType, ...) accepted by search filters and Essie expressions.
- [Search](https://firecrawl.dev/alexandria/agents/providers/clinicaltrials-gov/clinical-trials/search): Search the registry (GET /api/v2/studies). Filter by condition, intervention, sponsor, location, title, free-text Essie expression, overall status, distance from a coordinate or an advanced Essie filter. Returns one page of study summaries with raw date structs (date + ACTUAL/ESTIMATED type) and a page token for the next page. Repeat every query parameter with page_token to continue.
- [Study](https://firecrawl.dev/alexandria/agents/providers/clinicaltrials-gov/clinical-trials/study): One study record by NCT number (GET /api/v2/studies/{nctId}). Returns the raw registry record (protocolSection, derivedSection, documentSection, annotationSection; resultsSection only when include_results is true) plus the status dates lifted out. Use fields to request a subset of module or field pieces (e.g. ["StatusModule"]) and keep the response small.
- [Study dates](https://firecrawl.dev/alexandria/agents/providers/clinicaltrials-gov/clinical-trials/study_dates): Raw status and date metadata for up to 200 known NCT numbers in one request (GET /api/v2/studies?filter.ids=...). Each study returns overallStatus, lastKnownStatus, whyStopped, statusVerifiedDate and the start, primary-completion, completion, first-post and last-update-post date structs with their ACTUAL or ESTIMATED type exactly as the registry states them. NCT numbers the registry does not know are listed in not_found_ids; the call fails with not_found only when none of them is known.
- [Suggest](https://firecrawl.dev/alexandria/agents/providers/clinicaltrials-gov/clinical-trials/suggest): Autocomplete a prefix against one registry dictionary (GET /api/int/suggest): Condition, InterventionName, LeadSponsorName or LocationFacility. Returns the registry's suggestion strings, which can be used verbatim as search terms. An empty list is a legitimate answer for an unknown prefix.

## 1. Choose this provider when

ClinicalTrials.gov study registry via the public v2 REST API: search studies by condition, intervention, sponsor, location, status or Essie expression with page-token pagination; fetch one study record by NCT number; batch-resolve the raw ACTUAL/ESTIMATED start, primary-completion and completion dates for known NCT numbers; autocomplete conditions, interventions, sponsors and facilities; and read registry-wide field value statistics.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "clinicaltrials-gov",
  "capability": "clinical-trials/field_values",
  "options": {
    "fields": [
      "OverallStatus",
      "Phase",
      "StudyType"
    ]
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `fields` (string[], required): Field pieces, e.g. ["OverallStatus", "Phase"]. Unknown names fail with invalid_input. Example: `[]`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "clinicaltrials-gov",
    capability: "clinical-trials/field_values",
    options: {
      fields: [
        "OverallStatus",
        "Phase",
        "StudyType",
      ],
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "clinicaltrials-gov",
  "capability": "clinical-trials/field_values",
  "options": {
    "fields": [
      "OverallStatus",
      "Phase",
      "StudyType"
    ]
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "clinicaltrials-gov",
    "capability": "clinical-trials/field_values",
    "options": {
      "fields": [
        "OverallStatus",
        "Phase",
        "StudyType"
      ]
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'clinicaltrials-gov/clinical-trials/field_values' \
  --options '{"fields":["OverallStatus","Phase","StudyType"]}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "clinicaltrials-gov",
  "capability": "clinical-trials/field_values",
  "options": {
    "fields": [
      "OverallStatus",
      "Phase",
      "StudyType"
    ]
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "clinicaltrials-gov",
  "capability": "clinical-trials/field_values",
  "options": {
    "fields": [
      "OverallStatus",
      "Phase",
      "StudyType"
    ]
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "api_url": "https://clinicaltrials.gov/api/v2/stats/field/values?fields=OverallStatus,Phase,StudyType",
  "fields": [
    {
      "field": "protocolSection.statusModule.overallStatus",
      "missing_studies_count": 0,
      "piece": "OverallStatus",
      "stats": {},
      "top_values": [
        {
          "studies_count": 330531,
          "value": "COMPLETED"
        },
        {
          "studies_count": 96809,
          "value": "UNKNOWN"
        },
        {
          "studies_count": 65114,
          "value": "RECRUITING"
        },
        {
          "studies_count": 34392,
          "value": "TERMINATED"
        },
        {
          "studies_count": 30030,
          "value": "NOT_YET_RECRUITING"
        },
        {
          "studies_count": 22152,
          "value": "ACTIVE_NOT_RECRUITING"
        },
        {
          "studies_count": 16820,
          "value": "WITHDRAWN"
        },
        {
          "studies_count": 5270,
          "value": "ENROLLING_BY_INVITATION"
        },
        {
          "studies_count": 1781,
          "value": "SUSPENDED"
        },
        {
          "studies_count": 983,
          "value": "WITHHELD"
        },
        {
          "studies_count": 536,
          "value": "NO_LONGER_AVAILABLE"
        },
        {
          "studies_count": 253,
          "value": "AVAILABLE"
        },
        {
          "studies_count": 243,
          "value": "APPROVED_FOR_MARKETING"
        },
        {
          "studies_count": 36,
          "value": "TEMPORARILY_NOT_AVAILABLE"
        }
      ],
      "type": "ENUM",
      "unique_values_count": 14
    },
    {
      "field": "protocolSection.designModule.phases",
      "missing_studies_count": 143397,
      "piece": "Phase",
      "stats": {},
      "top_values": [
        {
          "studies_count": 237711,
          "value": "NA"
        },
        {
          "studies_count": 90396,
          "value": "PHASE2"
        },
        {
          "studies_count": 65846,
          "value": "PHASE1"
        },
        {
          "studies_count": 49946,
          "value": "PHASE3"
        },
        {
          "studies_count": 35871,
          "value": "PHASE4"
        },
        {
          "studies_count": 6493,
          "value": "EARLY_PHASE1"
        }
      ],
      "type": "ENUM",
      "unique_values_count": 6
    },
    {
      "field": "protocolSection.designModule.studyType",
      "missing_studies_count": 983,
      "piece": "StudyType",
      "stats": {},
      "top_values": [
        {
          "studies_count": 461679,
          "value": "INTERVENTIONAL"
        },
        {
          "studies_count": 141220,
          "value": "OBSERVATIONAL"
        },
        {
          "studies_count": 1068,
          "value": "EXPANDED_ACCESS"
        }
      ],
      "type": "ENUM",
      "unique_values_count": 3
    }
  ],
  "observed_at_ms": 1790705156544
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Field values

- Capability: `clinical-trials/field_values`
- Description: Registry-wide value statistics for up to 20 field pieces (GET /api/v2/stats/field/values): for enums and strings the distinct values with study counts, for dates and integers min/max, for booleans true/false counts, plus how many studies lack the field. Use it to learn the exact enum values (OverallStatus, Phase, StudyType, DateType, ...) accepted by search filters and Essie expressions.
- Instructions: You need the valid values of a registry field or the distribution of a field across all studies.
- Cost: 5 credits per call
- Capability file: [Field values](https://firecrawl.dev/alexandria/agents/providers/clinicaltrials-gov/clinical-trials/field_values)

Accepted options:
- `fields` (string[], required): Field pieces, e.g. ["OverallStatus", "Phase"]. Unknown names fail with invalid_input. Example: `[]`

Response schema example:
```json
{
  "api_url": "https://clinicaltrials.gov/api/v2/stats/field/values?fields=OverallStatus,Phase,StudyType",
  "fields": [
    {
      "field": "protocolSection.statusModule.overallStatus",
      "missing_studies_count": 0,
      "piece": "OverallStatus",
      "stats": {},
      "top_values": [
        {
          "studies_count": 330531,
          "value": "COMPLETED"
        },
        {
          "studies_count": 96809,
          "value": "UNKNOWN"
        },
        {
          "studies_count": 65114,
          "value": "RECRUITING"
        },
        {
          "studies_count": 34392,
          "value": "TERMINATED"
        },
        {
          "studies_count": 30030,
          "value": "NOT_YET_RECRUITING"
        },
        {
          "studies_count": 22152,
          "value": "ACTIVE_NOT_RECRUITING"
        },
        {
          "studies_count": 16820,
          "value": "WITHDRAWN"
        },
        {
          "studies_count": 5270,
          "value": "ENROLLING_BY_INVITATION"
        },
        {
          "studies_count": 1781,
          "value": "SUSPENDED"
        },
        {
          "studies_count": 983,
          "value": "WITHHELD"
        },
        {
          "studies_count": 536,
          "value": "NO_LONGER_AVAILABLE"
        },
        {
          "studies_count": 253,
          "value": "AVAILABLE"
        },
        {
          "studies_count": 243,
          "value": "APPROVED_FOR_MARKETING"
        },
        {
          "studies_count": 36,
          "value": "TEMPORARILY_NOT_AVAILABLE"
        }
      ],
      "type": "ENUM",
      "unique_values_count": 14
    },
    {
      "field": "protocolSection.designModule.phases",
      "missing_studies_count": 143397,
      "piece": "Phase",
      "stats": {},
      "top_values": [
        {
          "studies_count": 237711,
          "value": "NA"
        },
        {
          "studies_count": 90396,
          "value": "PHASE2"
        },
        {
          "studies_count": 65846,
          "value": "PHASE1"
        },
        {
          "studies_count": 49946,
          "value": "PHASE3"
        },
        {
          "studies_count": 35871,
          "value": "PHASE4"
        },
        {
          "studies_count": 6493,
          "value": "EARLY_PHASE1"
        }
      ],
      "type": "ENUM",
      "unique_values_count": 6
    },
    {
      "field": "protocolSection.designModule.studyType",
      "missing_studies_count": 983,
      "piece": "StudyType",
      "stats": {},
      "top_values": [
        {
          "studies_count": 461679,
          "value": "INTERVENTIONAL"
        },
        {
          "studies_count": 141220,
          "value": "OBSERVATIONAL"
        },
        {
          "studies_count": 1068,
          "value": "EXPANDED_ACCESS"
        }
      ],
      "type": "ENUM",
      "unique_values_count": 3
    }
  ],
  "observed_at_ms": 1790705156544
}
```

### Search

- Capability: `clinical-trials/search`
- Description: Search the registry (GET /api/v2/studies). Filter by condition, intervention, sponsor, location, title, free-text Essie expression, overall status, distance from a coordinate or an advanced Essie filter. Returns one page of study summaries with raw date structs (date + ACTUAL/ESTIMATED type) and a page token for the next page. Repeat every query parameter with page_token to continue.
- Instructions: Discover NCT numbers for a topic before calling study or study_dates; list trials by sponsor, status or location.
- Cost: 5 credits per call
- Capability file: [Search](https://firecrawl.dev/alexandria/agents/providers/clinicaltrials-gov/clinical-trials/search)

Accepted options:
- `advanced_filter` (string): Essie filter expression applied after the query (filter.advanced), e.g. AREA[StartDateType]ESTIMATED. Example: `<advanced_filter>`
- `agg_filters` (string): Facet filters as the site encodes them (aggFilters), e.g. "phase:3,status:rec". Pattern: ^[a-zA-Z]+:[a-zA-Z0-9_ ]+(,[a-zA-Z]+:[a-zA-Z0-9_ ]+)*$. Example: `<agg_filters>`
- `condition` (string): Condition or disease (query.cond), e.g. "Breast Cancer". Essie syntax allowed. Example: `<condition>`
- `intervention` (string): Intervention or treatment (query.intr), e.g. "Pembrolizumab". Example: `<intervention>`
- `location` (string): Location terms: city, state, country or facility (query.locn), e.g. "Boston". Example: `<location>`
- `near` (object): Only studies with a site within the radius of the coordinate (filter.geo=distance(lat,lon,radius)). Example: `{}`
- `page_size` (number): Studies per page (the API accepts up to 1000; capped at 100 here). Example: `10`
- `page_token` (string): next_page_token from the previous page. Send the same query parameters again. Pattern: ^[A-Za-z0-9_-]+$. Example: `<page_token>`
- `sort` (string): Sort by a field piece with optional direction, e.g. "LastUpdatePostDate:desc", or "@relevance" (default when a query is given). Pattern: ^(@relevance|[A-Za-z][A-Za-z0-9]*(:(asc|desc))?)$. Example: `<sort>`
- `sponsor` (string): Sponsor or collaborator name (query.spons), e.g. "Merck". Example: `<sponsor>`
- `status` (string[]): Overall status filter (filter.overallStatus); any of the listed values matches. Example: `[]`
- `term` (string): Other terms searched across the record (query.term). Accepts Essie expressions such as AREA[StartDate]RANGE[2025-01-01,MAX]. Example: `<term>`
- `title` (string): Words in the brief or official title, or acronym (query.titles). Example: `<title>`

Response schema example:
```json
{
  "api_url": "https://clinicaltrials.gov/api/v2/studies?query.cond=Breast%20Cancer&query.intr=Pembrolizumab&fields=NCTId,BriefTitle,OfficialTitle,Acronym,OverallStatus,WhyStopped,StudyType,Phase,Condition,InterventionName,InterventionType,LeadSponsorName,LeadSponsorClass,StartDateStruct,PrimaryCompletionDateStruct,CompletionDateStruct,StudyFirstPostDateStruct,LastUpdatePostDateStruct,EnrollmentInfo,HasResults,LocationCountry&countTotal=true&pageSize=3",
  "next_page_token": "ZVNj7o2Elu8o3lpwUd7_5bbumpOQJJxsY_Cl1Pg",
  "observed_at_ms": 1790705160120,
  "source_url": "https://clinicaltrials.gov/search?cond=Breast%20Cancer&intr=Pembrolizumab",
  "studies": [
    {
      "acronym": null,
      "brief_title": "Safety and Efficacy of p53 Gene Therapy Combined With Immune Checkpoint Inhibitors in Solid Tumors.",
      "completion_date": {
        "date": "2022-12-31",
        "type": "ESTIMATED"
      },
      "conditions": [
        "Solid Tumor",
        "Lymphoma"
      ],
      "countries": [
        "United States"
      ],
      "enrollment": {
        "count": 40,
        "type": "ESTIMATED"
      },
      "has_results": false,
      "interventions": [
        {
          "name": "Ad-p53",
          "type": "DRUG"
        }
      ],
      "last_update_post_date": {
        "date": "2020-06-09",
        "type": "ACTUAL"
      },
      "lead_sponsor": {
        "class": "INDUSTRY",
        "name": "MultiVir, Inc."
      },
      "nct_id": "NCT03544723",
      "official_title": "A Phase 2, Multi-Center, Open Label Study to Evaluate Adenoviral p53 (Ad-p53) in Combination With Immune Checkpoint Inhibitor Therapy in Patients With Recurrent or Metastatic Head and Neck Squamous Cell Carcinoma and Other Tumors Approved for Anti-PD-1 or Anti-PD-L1 Therapy",
      "overall_status": "UNKNOWN",
      "phases": [
        "PHASE2"
      ],
      "primary_completion_date": {
        "date": "2022-06-30",
        "type": "ESTIMATED"
      },
      "source_url": "https://clinicaltrials.gov/study/NCT03544723",
      "start_date": {
        "date": "2018-10-01",
        "type": "ACTUAL"
      },
      "study_first_post_date": {
        "date": "2018-06-04",
        "type": "ACTUAL"
      },
      "study_type": "INTERVENTIONAL",
      "why_stopped": null
    },
    {
      "acronym": null,
      "brief_title": "A Phase II Study Evaluating the Efficacy and Safety of Pembrolizumab in Combination With Chemotherapy as Neoadjuvant Therapy for Triple-negative Breast Cancer",
      "completion_date": {
        "date": "2024-06-01",
        "type": "ESTIMATED"
      },
      "conditions": [
        "Breast Cancer"
      ],
      "countries": [
        "China"
      ],
      "enrollment": {
        "count": 26,
        "type": "ESTIMATED"
      },
      "has_results": false,
      "interventions": [
        {
          "name": "Pembrolizumab",
          "type": "DRUG"
        },
        {
          "name": "Paclitaxel",
          "type": "DRUG"
        },
        {
          "name": "Epirubicin",
          "type": "DRUG"
        },
        {
          "name": "Cyclophosphamide",
          "type": "DRUG"
        }
      ],
      "last_update_post_date": {
        "date": "2023-01-12",
        "type": "ACTUAL"
      },
      "lead_sponsor": {
        "class": "OTHER",
        "name": "Cancer Institute and Hospital, Chinese Academy of Medical Sciences"
      },
      "nct_id": "NCT05681728",
      "official_title": "A Phase II Study Evaluating the Efficacy and Safety of Pembrolizumab in Combination With Chemotherapy as Neoadjuvant Therapy for Triple-negative Breast Cancer",
      "overall_status": "UNKNOWN",
      "phases": [
        "PHASE2"
      ],
      "primary_completion_date": {
        "date": "2024-02-01",
        "type": "ESTIMATED"
      },
      "source_url": "https://clinicaltrials.gov/study/NCT05681728",
      "start_date": {
        "date": "2022-02-01",
        "type": "ACTUAL"
      },
      "study_first_post_date": {
        "date": "2023-01-12",
        "type": "ACTUAL"
      },
      "study_type": "INTERVENTIONAL",
      "why_stopped": null
    },
    {
      "acronym": null,
      "brief_title": "A Study of LY3435151 in Participants With Solid Tumors",
      "completion_date": {
        "date": "2020-03-05",
        "type": "ACTUAL"
      },
      "conditions": [
        "Solid Tumor",
        "Triple-negative Breast Cancer",
        "Gastric Adenocarcinoma",
        "Head and Neck Squamous Cell Carcinoma",
        "Cervical Carcinoma",
        "High Grade Serous Ovarian Carcinoma",
        "Hepatocellular Carcinoma",
        "Undifferentiated Pleomorphic Sarcoma",
        "Leiomyosarcoma"
      ],
      "countries": [
        "United States",
        "Japan"
      ],
      "enrollment": {
        "count": 2,
        "type": "ACTUAL"
      },
      "has_results": true,
      "interventions": [
        {
          "name": "LY3435151",
          "type": "DRUG"
        },
        {
          "name": "Pembrolizumab",
          "type": "DRUG"
        }
      ],
      "last_update_post_date": {
        "date": "2021-08-31",
        "type": "ACTUAL"
      },
      "lead_sponsor": {
        "class": "INDUSTRY",
        "name": "Eli Lilly and Company"
      },
      "nct_id": "NCT04099277",
      "official_title": "A Phase 1a/1b Study of LY3435151 Administered to Patients With Advanced Solid Tumors",
      "overall_status": "TERMINATED",
      "phases": [
        "PHASE1"
      ],
      "primary_completion_date": {
        "date": "2020-03-05",
        "type": "ACTUAL"
      },
      "source_url": "https://clinicaltrials.gov/study/NCT04099277",
      "start_date": {
        "date": "2019-10-28",
        "type": "ACTUAL"
      },
      "study_first_post_date": {
        "date": "2019-09-23",
        "type": "ACTUAL"
      },
      "study_type": "INTERVENTIONAL",
      "why_stopped": "Study terminated due to strategic business decision by Eli Lilly and Company."
    }
  ],
  "total_count": 339
}
```

### Study

- Capability: `clinical-trials/study`
- Description: One study record by NCT number (GET /api/v2/studies/{nctId}). Returns the raw registry record (protocolSection, derivedSection, documentSection, annotationSection; resultsSection only when include_results is true) plus the status dates lifted out. Use fields to request a subset of module or field pieces (e.g. ["StatusModule"]) and keep the response small.
- Instructions: You have an NCT number (from search, a pasted clinicaltrials.gov/study URL or elsewhere) and need the full protocol, eligibility, locations, outcomes or posted results.
- Cost: 5 credits per call
- Capability file: [Study](https://firecrawl.dev/alexandria/agents/providers/clinicaltrials-gov/clinical-trials/study)

Accepted options:
- `fields` (string[]): Field pieces to return (names from /api/v2/studies/metadata, e.g. StatusModule, IdentificationModule, EligibilityModule, ResultsSection). Default: every section except results. Example: `[]`
- `include_results` (boolean): Include resultsSection (posted results; can be megabytes) when fields is not given. Example: `false`
- `nct_id` (string): NCT number, e.g. NCT05159778. Mutually exclusive with url. Pattern: ^[Nn][Cc][Tt][0-9]{8}$. Example: `<nct_id>`
- `url` (string): A clinicaltrials.gov/study/NCT... or classic ct2/show/NCT... URL. Mutually exclusive with nct_id. Pattern: ^https?://. Example: `<url>`

Response schema example:
```json
{
  "api_url": "https://clinicaltrials.gov/api/v2/studies/NCT05159778?fields=IdentificationModule,StatusModule,HasResults,NCTId",
  "brief_title": "Phase 2 Study of Imprime PGG and Pembrolizumab in Patients With HR+/HER2- Metastatic Breast Cancer (mBCA)",
  "completion_date": {
    "date": "2023-04-12",
    "type": "ACTUAL"
  },
  "has_results": false,
  "nct_id": "NCT05159778",
  "observed_at_ms": 1790705145940,
  "overall_status": "COMPLETED",
  "primary_completion_date": {
    "date": "2023-03-22",
    "type": "ACTUAL"
  },
  "record": {
    "hasResults": false,
    "protocolSection": {
      "identificationModule": {
        "briefTitle": "Phase 2 Study of Imprime PGG and Pembrolizumab in Patients With HR+/HER2- Metastatic Breast Cancer (mBCA)",
        "nctId": "NCT05159778",
        "officialTitle": "A Multicenter, Open-label, Phase 2 Study of Imprime PGG and Pembrolizumab in Patients With Metastatic Breast Cancer (mBCA) Who Have Progressed Through Prior Hormonal Therapy",
        "orgStudyIdInfo": {
          "id": "PGG-BCA2121 / MK-3475-C99"
        },
        "organization": {
          "class": "INDUSTRY",
          "fullName": "HiberCell, Inc."
        }
      },
      "statusModule": {
        "completionDateStruct": {
          "date": "2023-04-12",
          "type": "ACTUAL"
        },
        "expandedAccessInfo": {
          "hasExpandedAccess": false
        },
        "lastUpdatePostDateStruct": {
          "date": "2023-06-22",
          "type": "ACTUAL"
        },
        "lastUpdateSubmitDate": "2023-06-19",
        "overallStatus": "COMPLETED",
        "primaryCompletionDateStruct": {
          "date": "2023-03-22",
          "type": "ACTUAL"
        },
        "startDateStruct": {
          "date": "2021-11-09",
          "type": "ACTUAL"
        },
        "statusVerifiedDate": "2022-07",
        "studyFirstPostDateStruct": {
          "date": "2021-12-16",
          "type": "ACTUAL"
        },
        "studyFirstSubmitDate": "2021-11-10",
        "studyFirstSubmitQcDate": "2021-12-02"
      }
    }
  },
  "source_url": "https://clinicaltrials.gov/study/NCT05159778",
  "start_date": {
    "date": "2021-11-09",
    "type": "ACTUAL"
  }
}
```

### Study dates

- Capability: `clinical-trials/study_dates`
- Description: Raw status and date metadata for up to 200 known NCT numbers in one request (GET /api/v2/studies?filter.ids=...). Each study returns overallStatus, lastKnownStatus, whyStopped, statusVerifiedDate and the start, primary-completion, completion, first-post and last-update-post date structs with their ACTUAL or ESTIMATED type exactly as the registry states them. NCT numbers the registry does not know are listed in not_found_ids; the call fails with not_found only when none of them is known.
- Instructions: You already have NCT numbers and need to know whether their start and primary completion dates are actual or estimated, or their current status.
- Cost: 5 credits per call
- Capability file: [Study dates](https://firecrawl.dev/alexandria/agents/providers/clinicaltrials-gov/clinical-trials/study_dates)

Accepted options:
- `nct_ids` (string[], required): NCT numbers to resolve. Duplicates are collapsed. Example: `[]`

Response schema example:
```json
{
  "api_url": "https://clinicaltrials.gov/api/v2/studies?filter.ids=NCT05159778,NCT03544723,NCT05681728&fields=NCTId,OverallStatus,LastKnownStatus,WhyStopped,StatusVerifiedDate,StartDateStruct,PrimaryCompletionDateStruct,CompletionDateStruct,StudyFirstPostDateStruct,LastUpdatePostDateStruct&countTotal=true&pageSize=1000",
  "found_count": 3,
  "not_found_ids": [],
  "observed_at_ms": 1790705149522,
  "requested_count": 3,
  "studies": [
    {
      "completion_date": {
        "date": "2023-04-12",
        "type": "ACTUAL"
      },
      "last_known_status": null,
      "last_update_post_date": {
        "date": "2023-06-22",
        "type": "ACTUAL"
      },
      "nct_id": "NCT05159778",
      "overall_status": "COMPLETED",
      "primary_completion_date": {
        "date": "2023-03-22",
        "type": "ACTUAL"
      },
      "source_url": "https://clinicaltrials.gov/study/NCT05159778",
      "start_date": {
        "date": "2021-11-09",
        "type": "ACTUAL"
      },
      "status_verified_date": "2022-07",
      "study_first_post_date": {
        "date": "2021-12-16",
        "type": "ACTUAL"
      },
      "why_stopped": null
    },
    {
      "completion_date": {
        "date": "2022-12-31",
        "type": "ESTIMATED"
      },
      "last_known_status": "RECRUITING",
      "last_update_post_date": {
        "date": "2020-06-09",
        "type": "ACTUAL"
      },
      "nct_id": "NCT03544723",
      "overall_status": "UNKNOWN",
      "primary_completion_date": {
        "date": "2022-06-30",
        "type": "ESTIMATED"
      },
      "source_url": "https://clinicaltrials.gov/study/NCT03544723",
      "start_date": {
        "date": "2018-10-01",
        "type": "ACTUAL"
      },
      "status_verified_date": "2020-06",
      "study_first_post_date": {
        "date": "2018-06-04",
        "type": "ACTUAL"
      },
      "why_stopped": null
    },
    {
      "completion_date": {
        "date": "2024-06-01",
        "type": "ESTIMATED"
      },
      "last_known_status": "RECRUITING",
      "last_update_post_date": {
        "date": "2023-01-12",
        "type": "ACTUAL"
      },
      "nct_id": "NCT05681728",
      "overall_status": "UNKNOWN",
      "primary_completion_date": {
        "date": "2024-02-01",
        "type": "ESTIMATED"
      },
      "source_url": "https://clinicaltrials.gov/study/NCT05681728",
      "start_date": {
        "date": "2022-02-01",
        "type": "ACTUAL"
      },
      "status_verified_date": "2022-12",
      "study_first_post_date": {
        "date": "2023-01-12",
        "type": "ACTUAL"
      },
      "why_stopped": null
    }
  ]
}
```

### Suggest

- Capability: `clinical-trials/suggest`
- Description: Autocomplete a prefix against one registry dictionary (GET /api/int/suggest): Condition, InterventionName, LeadSponsorName or LocationFacility. Returns the registry's suggestion strings, which can be used verbatim as search terms. An empty list is a legitimate answer for an unknown prefix.
- Instructions: Normalize a drug, condition, sponsor or facility name to the spelling the registry uses before searching.
- Cost: 5 credits per call
- Capability file: [Suggest](https://firecrawl.dev/alexandria/agents/providers/clinicaltrials-gov/clinical-trials/suggest)

Accepted options:
- `dictionary` (string): dictionary Example: `Condition`
- `input` (string, required): Prefix or partial name, e.g. "pembro". Example: `<input>`

Response schema example:
```json
{
  "api_url": "https://clinicaltrials.gov/api/int/suggest?input=pembro&dictionary=InterventionName",
  "count": 5,
  "dictionary": "InterventionName",
  "input": "pembro",
  "observed_at_ms": 1790705152983,
  "suggestions": [
    "Pembrolizumab",
    "Pembrolizumab KEYTRUDA®",
    "Pembrolizumab Injection",
    "Pembrolizumab Injection \\[Keytruda\\]",
    "Pembrolizumab 200 mg"
  ]
}
```
