---
title: "B012 Clinical Trial Search"
method: POST
path: "/synapse/clinical-trial/search"
tags: ["LS Search"]
---

# B012 Clinical Trial Search

`POST /synapse/clinical-trial/search`

## Request

- Base URL: `https://connect.patsnap.com`
- URL: `https://connect.patsnap.com/synapse/clinical-trial/search`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/docs/synapse/clinical-trial/search/post.ts> (a function with typed inputs; its response is checked against the schema)

Obtain clinical trial through fields such as target, organization, disease, etc.

## Request body

- B012ClinicalTrialSearchRequest
  - `offset` integer: Offset, default 0
  - `limit` integer: Limit, default 10. offset + limit <= 20000， limit up to 1,000.
  - `keyword` B012ClinicalTrialSearchClinicalTrialSearchKeywordConditionValue
    - `condition` string: Logical operators, The value is an enum with the following values:AND,OR. Case-sensitive.
    - `value` unknown[]: Value List
      - unknown
  - `main_experimentation_drug` B012ClinicalTrialSearchClinicalTrialSearchMainExperimentationDrugConditionValue
    - `condition` string: Logical operators, The value is an enum with the following values:AND,OR. Case-sensitive.
    - `value` unknown[]: Value List
      - unknown
  - `control_drug` B012ClinicalTrialSearchClinicalTrialSearchControlDrugConditionValue
    - `condition` string: Logical operators, The value is an enum with the following values:AND,OR. Case-sensitive.
    - `value` unknown[]: Value List
      - unknown
  - `organization` B012ClinicalTrialSearchClinicalTrialSearchOrganizationConditionValue
    - `condition` string: Logical operators, The value is an enum with the following values:AND,OR. Case-sensitive.
    - `value` unknown[]: Value List
      - unknown
  - `target` B012ClinicalTrialSearchClinicalTrialSearchTargetConditionValue
    - `condition` string: Logical operators, The value is an enum with the following values:AND,OR. Case-sensitive.
    - `value` unknown[]: Value List
      - unknown
  - `mechanism_action` B012ClinicalTrialSearchClinicalTrialSearchMechanismActionConditionValue
    - `condition` string: Logical operators, The value is an enum with the following values:AND,OR. Case-sensitive.
    - `value` unknown[]: Value List
      - unknown
  - `disease` B012ClinicalTrialSearchClinicalTrialSearchDiseaseConditionValue
    - `condition` string: Logical operators, The value is an enum with the following values:AND,OR. Case-sensitive.
    - `value` unknown[]: Value List
      - unknown
  - `drug_type` B012ClinicalTrialSearchClinicalTrialSearchDrugTypeConditionValue
    - `condition` string: Logical operators, The value is an enum with the following values:AND,OR. Case-sensitive.
    - `value` unknown[]: Value List
      - unknown
  - `study_identifier` B012ClinicalTrialSearchClinicalTrialSearchStudyIdentifierConditionValue
    - `condition` string: Logical operators, The value is an enum with the following values:AND,OR. Case-sensitive.
    - `value` unknown[]: Value List
      - unknown
  - `register_number` B012ClinicalTrialSearchClinicalTrialSearchRegisterNumberConditionValue
    - `condition` string: Logical operators, The value is an enum with the following values:AND,OR. Case-sensitive.
    - `value` unknown[]: Value List
      - unknown
  - `title` B012ClinicalTrialSearchClinicalTrialSearchTitleConditionValue
    - `condition` string: Logical operators, The value is an enum with the following values:AND,OR. Case-sensitive.
    - `value` unknown[]: Value List
      - unknown
  - `recruitment_status` unknown[]: Recruitment Status, The value is an enum with the following values: Not_Yet_Recruiting, Recruiting, Enrolling_By_Invitation, Active_Not_Recruiting, Suspended, Terminated, Completed, Withdrawn, Unknown_Status
    - unknown
  - `phase` unknown[]: Study Phase, The value is an enum with the following values: Early_Phase_1, Phase_1, Phase_1_2, Phase_2, Phase_2_3, Phase_3, Phase_4, Not_Applicable
    - unknown
  - `start_date` B012ClinicalTrialSearchClinicalTrialSearchStartDateLongRangeItem
    - `from` integer: from
    - `to` integer: to
  - `first_posted_date` B012ClinicalTrialSearchClinicalTrialSearchFirstPostedDateLongRangeItem
    - `from` integer: from
    - `to` integer: to
  - `enrollment` unknown[]: Enrollment, The value is an enum with the following values: LESS_THAN_FIFTEEN, FIFTEEN_TO_SIXTY, SIXTY_TO_THREE_HUNDRED, THREE_HUNDRED_TO_FIVE_HUNDRED, GREATER_THAN_FIVE_HUNDRED
    - unknown
  - `organization_type` unknown[]: Organization Type, The value is an enum with the following values: Company, University_Institution, Other
    - unknown
  - `employee_number` unknown[]: Employee Number, The value is an enum with the following values: LESS_THAN_10, BETWEEN_10_AND_100, BETWEEN_100_AND_500, GREATER_THAN_500
    - unknown
  - `country` unknown[]: Country/Location, The value is an enum with the following values: Asia, North_America, Europe, Oceania, South_America, US, EU, CN, JP, Other
    - unknown
  - `therapeutic_area` unknown[]: Therapeutic Areas, Retrieve therapeutic area id using the [B058].
    - unknown
  - `sort` B012ClinicalTrialSearchClinicalTrialSearchSortDto[]: Sorting fields. The value is an enum with the following values: STUDY_FIRST_POSTED_DATE, START_DATE, LAST_UPDATE_POSTED_DATE. The default sorting is by first post date, start date, and last post date, all in descending order. Referencing "ClinicalTrialSearchSortDto"
    - `sort_field` string: sort field, enum values: STUDY_FIRST_POSTED_DATE, START_DATE, LAST_UPDATE_POSTED_DATE
    - `sort_order` string: sort order, support:desc,asc

## Response `200`

Successful b012 clinical trial search response.

- B012ClinicalTrialSearchResponse
  - `data` B012ClinicalTrialSearchClinicalTrialSearchResponseDto
    - `items` B012ClinicalTrialSearchClinicalTrialSearchDetail[]: Result Items
      - `brief_title` string: Brief Title
      - `official_title` string: Official Title
      - `register_number` string: Trial Number
      - `clinical_trial_id` string: Clinical Trial ID
    - `limit` integer: limit
    - `total` integer: total
    - `offset` integer: offset
  - `status` boolean, required: Status
  - `error_msg` string: Error Message
  - `error_code` integer, required: Error Code

## Other responses

- `201`: Created.
- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: Not Found.

---

[API](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api.md) - [All operations](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/patsnap/apis/patsnap-open-platform-api/revisions/c2264a0de595?raw)