---
title: "GET /search"
method: GET
path: "/search"
tags: ["trials"]
---

# GET /search

`GET /search`

Find trials using a simple keyword(s) based search. At the moment, operators (`AND`, `OR`)are not implemented. If the results span across multiple pages, use the `page` parameter to request a specific page and `per_page` to alter the number of results returned on a single page.
- `page` can take a value between `1` and `100`
- `per_page` can take a value between `10` and `100`

## Query parameters

- `q` string
- `page` integer
- `per_page` integer

## Response `200`

Success

- TrialSearchResults
  - `total_count` integer, required
  - `items` Trial[], required
    - `id` string, required — ID of the trial
    - `source_id` string — ID of the trial's source
    - `identifiers` object — Object that maps the trial's sources ids with its identifiers.
    - `url` string, required — Source URL (where the trial was collected from)
    - `public_title` string, required — Title of the trial
    - `brief_summary` string — Summary of the trial
    - `target_sample_size` integer — Target sample size for the trial
    - `gender` 'both' | 'male' | 'female' — Gender of the subjects of the trial
    - `has_published_results` boolean — Trial has its results published (true/false)
    - `registration_date` string, date-time — Date the trial was registered
    - `status` 'ongoing' | 'withdrawn' | 'suspended' | 'terminated' | 'complete' | 'other' — Completion status of the trial
    - `recruitment_status` 'recruiting' | 'not_recruiting' | 'unknown' | 'other' — Recruitment status of the trial
    - `locations` TrialLocation[], required — Locations related to the trial
      - `id` string, required — ID of the location
      - `name` string, required — Name of the location
      - `type` 'country' | 'city' | 'other' — Type of the location (country / city / other)
      - `role` 'recruitment_countries' | 'other'
    - `interventions` Intervention[], required — Interventions related to the trial
      - `id` string, required — ID of the intervention
      - `name` string, required — Name of the intervention
      - `url` string, required — OpenTrials API URL of the intervention
      - `type` 'drug' | 'other' — Type of the intervention (drug / other)
    - `conditions` Condition[] — Conditions the trial refers to
      - `id` string, required — ID of the condition
      - `name` string, required — Name of the condition
      - `url` string, required — OpenTrials API URL of the condition
    - `persons` TrialPerson[], required — People related to the trial
      - `id` string, required — ID of the person
      - `name` string, required — Name of the person
      - `url` string, required — OpenTrials API URL of the person
      - `role` 'principal_investigator' | 'public_queries' | 'scientific_queries' | 'other'
    - `organisations` TrialOrganisation[], required — Organisations related to the trial
      - `id` string, required — ID of the organisation
      - `name` string, required — Name of the organisation
      - `url` string, required — OpenTrials API URL of the organisation
      - `role` 'primary_sponsor' | 'sponsor' | 'funder' | 'other'
    - `records` RecordSummary[], required — (published) records of the trial
      - `id` string, required
      - `url` string, required
      - `source_id` string, required
    - `publications` PublicationSummary[], required — Publications referring the trial
      - `id` string, required
      - `url` string, required
      - `title` string, required
      - `source_id` string, required
    - `discrepancies` object — Discrepancies in trial's details between different sources
    - `documents` Document[] — Documents related to the trial
      - `name` string, required
      - `type` 'csr' | 'csr_synopsis' | 'epar_segment' | 'blank_consent_form' | 'patient_information_sheet' | 'blank_case_report_form' | 'results' | 'other', required
      - `url` string, required
      - `documentcloud_id` string
      - `text` string
    - `sources` object, required

## Other responses

- `default` — Error

## Changes

- **2016-09-04** `c55bfe84e6b6` — 1 info
  - api operation id `search` removed and replaced with `searchTrials`
- **2016-05-31** `7a0eb1704719` — 1 info
  - api operation id `searchTrials` removed and replaced with `search`

[Change history](https://skmtc.dev/opentrials/apis/opentrials-api/changes/search/get.md)

---

[API](https://skmtc.dev/opentrials/apis/opentrials-api.md) · [All operations](https://skmtc.dev/opentrials/apis/opentrials-api/llms.txt) · [OpenAPI document](https://skmtc.dev/opentrials/apis/opentrials-api/revisions/c55bfe84e6b6?raw)