# /euctis/trials/search

`POST /api/euctis/trials/search`

Price: 20 credits

Search authorised EU/EEA clinical trials in the EU Clinical Trials Information System. Narrows by free text, title, trial or EudraCT number, sponsor protocol code, medical condition, sponsor, end point, investigational product, orphan designation number, overall and per-member-state status, member states concerned, trial phase, MeSH therapeutic area, sponsor organisation type, age group, sex, population type, product role, EEA/non-EEA region, the rare-disease, orphan, low-intervention and transitioned flags, the results, clinical-study-report, serious-breach, unexpected-event and urgent-safety-measure flags, and the EEA start and end dates. Each result is the register summary of one trial.

## How to use it

CTIS covers only trials applied for under Regulation 536/2014, so a European trial that started before the 2022 transition is on the eudract register instead unless its sponsor moved it — `transitioned_from_eudract` is what separates the moved ones, and `eudract_number` looks a trial up by its old identifier. The register orders by decision date, and no search can reach past its 10,000th row however large `count` is, so narrow with `member_states` or a date window rather than paging for a whole therapeutic area. `query` requires every word while `query_any` requires one, and both search the whole record rather than the title. Feed `id` to euctis/trials for the authorisation decisions, trial sites, products and document list.

## Parameters

- `access-token` (string, required)

## Request body

- `timeout` (integer) — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
- `query` (string, nullable) — Free text that must appear in the trial record, every word of it (examples: "breast cancer"; minLength: 1)
- `query_any` (string, nullable) — Free text of which any one word is enough to match (examples: "melanoma carcinoma"; minLength: 1)
- `query_exclude` (string, nullable) — Free text that must NOT appear in the trial record (examples: "placebo"; minLength: 1)
- `trial_title` (string, nullable) — Text matched against the trial title only (examples: "diabetes"; minLength: 1)
- `trial_number` (string, nullable) — CTIS trial number, matched exactly (examples: "2025-524215-36-00"; minLength: 1)
- `eudract_number` (string, nullable) — EudraCT number of the legacy trial this CTIS record was transitioned from (examples: "2021-000546-17"; minLength: 1)
- `protocol_code` (string, nullable) — Sponsor's own protocol code (examples: "D8534C00001"; minLength: 1)
- `medical_condition` (string, nullable) — Text matched against the medical conditions under investigation (examples: "cancer"; minLength: 1)
- `sponsor` (string, nullable) — Text matched against the sponsor's name (examples: "Pfizer"; minLength: 1)
- `end_point` (string, nullable) — Text matched against the trial end points (examples: "overall survival"; minLength: 1)
- `product_name` (string, nullable) — Text matched against investigational product names (examples: "IBRANCE"; minLength: 1)
- `orphan_designation_number` (string, nullable) — EU orphan designation number of a product in the trial (examples: "EU/3/15/1574"; minLength: 1)
- `status` (array, nullable) — Keep trials whose overall CTIS status is one of these (one of: "under_evaluation", "authorised_recruitment_pending", "authorised_recruiting", "ongoing_recruiting", "ongoing_recruitment_ended", "temporarily_halted", "suspended", "ended", "expired", "revoked", "not_authorised", "cancelled")
- `member_state_status` (array, nullable) — Keep trials that hold one of these statuses in at least one member state (one of: "under_evaluation", "authorised_recruitment_pending", "authorised_recruiting", "ongoing_recruiting", "ongoing_recruitment_ended", "temporarily_halted", "suspended", "ended", "expired", "revoked", "not_authorised", "cancelled")
- `member_states` (array, nullable) — Lowercase ISO-3166 alpha-2 codes of the EU/EEA member states concerned (examples: ["fr","de"])
- `phase` (array, nullable) — Keep trials in one of these trial phases (one of: "phase_1_first_in_human", "phase_1_bioequivalence", "phase_1_other", "phase_2", "phase_3", "phase_4", "phase_1_2_first_in_human", "phase_1_2_bioequivalence", "phase_1_2_other", "phase_2_3", "phase_3_4")
- `therapeutic_areas` (array, nullable) — MeSH therapeutic-area codes as they appear in the record, for example C04 for neoplasms (examples: ["C04"])
- `sponsor_type` (array, nullable) — Keep trials whose sponsor is one of these kinds of organisation (one of: "educational_institution", "health_care", "industry", "patient_organisation", "hospital_or_clinic", "laboratory_or_research_facility", "pharmaceutical_company", "non_pharmaceutical_company", "pharmaceutical_association")
- `age_groups` (array, nullable) — Keep trials recruiting one of these age groups (one of: "in_utero", "under_18", "adults_18_64", "elderly_65_plus")
- `sexes` (array, nullable) — Keep trials recruiting subjects of this sex (one of: "male", "female")
- `population_type` (array, nullable) — Keep trials recruiting patients or healthy volunteers (one of: "healthy_volunteers", "patients")
- `product_role` (array, nullable) — Keep trials carrying a product in one of these roles (one of: "test", "comparator", "placebo", "auxiliary")
- `region` (array, nullable) — Keep trials run inside the EEA, outside it, or in both (one of: "eea_only", "non_eea_only", "both")
- `rare_disease` (boolean, nullable) — Trial investigates a rare disease
- `orphan_designated` (boolean, nullable) — A product in the trial holds an orphan designation
- `low_intervention` (boolean, nullable) — Trial is a low-intervention clinical trial
- `transitioned_from_eudract` (boolean, nullable) — Trial was transitioned into CTIS from the legacy EudraCT register
- `has_results` (boolean, nullable) — A summary of results has been submitted
- `has_clinical_study_report` (boolean, nullable) — A clinical study report has been submitted
- `has_serious_breach` (boolean, nullable) — A serious breach has been reported
- `has_unexpected_event` (boolean, nullable) — An unexpected event has been reported
- `has_urgent_safety_measure` (boolean, nullable) — An urgent safety measure has been reported
- `start_date_from` (string, nullable) — Keep trials whose EEA start date is on or after this date, YYYY-MM-DD (examples: "2024-01-01")
- `start_date_to` (string, nullable) — Keep trials whose EEA start date is on or before this date, YYYY-MM-DD (examples: "2024-12-31")
- `end_date_from` (string, nullable) — Keep trials whose EEA end date is on or after this date, YYYY-MM-DD (examples: "2026-01-01")
- `end_date_to` (string, nullable) — Keep trials whose EEA end date is on or before this date, YYYY-MM-DD (examples: "2026-12-31")
- `sort` (string) — Field the result set is ordered by (default: "decision_date"; one of: "decision_date", "ct_number", "sponsor")
- `order` (string) — Sort direction (default: "desc"; one of: "asc", "desc")
- `count` (integer, required) — Number of trials to return (min: 1; max: 10000)

## Response

### 200 — Successful Response

- `@type` (string) (default: "EuctisTrial")
- `id` (string, required)
- `url` (string) (default: "")
- `short_title` (string, nullable)
- `status` (string) (default: "")
- `status_code` (string, nullable)
- `sponsor` (string, nullable)
- `sponsor_type` (string, nullable)
- `phase` (string, nullable)
- `conditions` (string, nullable)
- `therapeutic_areas` (array) (default: [])
- `product` (string, nullable)
- `countries` (array) (default: [])
  - `@type` (string) (default: "EuctisTrialCountry")
  - `country` (string) (default: "")
  - `status` (string) (default: "")
  - `status_code` (string, nullable)
- `region` (string, nullable)
- `age_groups` (array) (default: [])
- `secondary_age_range_codes` (array) (default: [])
- `sexes` (array) (default: [])
- `total_enrolled` (integer, nullable)
- `primary_end_point` (string, nullable)
- `end_point` (string, nullable)
- `has_results` (boolean, nullable)
- `decision_date` (string, nullable)
- `decision_dates_by_country` (string, nullable)
- `start_date` (string, nullable)
- `end_date` (string, nullable)
- `global_end_date` (string, nullable)
- `updated_date` (string, nullable)
- `published_update_date` (string, nullable)

## Errors

### 422 — Validation Error

A date field was not YYYY-MM-DD, or a member state or therapeutic-area code was not recognised.

What to do: Check the fields against this schema. A URN with the wrong prefix is the most common cause.

- `detail` (array)
  - `loc` (array, required)
  - `msg` (string, required)
  - `type` (string, required)
  - `input` (any)
  - `ctx` (object)

### 408

The request ran past its time limit

What to do: 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

No CTIS trial matched those filters.

What to do: 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

What to do: 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

What to do: 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

What to do: Wait at least 30 seconds, then retry.

## Response envelope

Success: Array of objects (may be empty if no results)

Error: Error may coexist with partial results if it occurs mid-execution. Check X-Error header and status code.

Every response carries these 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.