Ctis Tools#

Configuration File: ctis_tools.json Tool Type: Local Tools Count: 3

This page contains all tools defined in the ctis_tools.json configuration file.

Available Tools#

CTIS_get_trial (Type: CTISGetTrialTool)#

Retrieve complete top-level public CTIS trial metadata by CT number, including human-readable and…

CTIS_get_trial tool specification

Tool Information:

  • Name: CTIS_get_trial

  • Type: CTISGetTrialTool

  • Description: Retrieve complete top-level public CTIS trial metadata by CT number, including human-readable and coded status/region, key dates, authorized Part I/II application details, member states, events, results, corrective measures, and the full public document manifest (protocol and other publication files with UUID/type/version metadata). No API key required.

Parameters:

  • ct_number (string) (required) CTIS CT number, e.g. ‘2022-503001-38-01’.

Example Usage:

query = {
    "name": "CTIS_get_trial",
    "arguments": {
        "ct_number": "example_value"
    }
}
result = tu.run(query)

CTIS_search_trials (Type: CTISSearchTrialsTool)#

Search EU CTIS with strict, recoverable one-based pagination. Returns exact total_records plus ha…

CTIS_search_trials tool specification

Tool Information:

  • Name: CTIS_search_trials

  • Type: CTISSearchTrialsTool

  • Description: Search EU CTIS with strict, recoverable one-based pagination. Returns exact total_records plus has_more and next_page; continue with the same query and limit while has_more is true. Records preserve CT number, full and short titles, status, conditions, investigational products, primary and other endpoints, phase, sponsor, countries, age criteria, enrollment, decision dates, results availability, and publication/update dates. No API key required.

Parameters:

  • query (string) (required) Free-text search, e.g. ‘breast cancer’, ‘pembrolizumab’, ‘cystic fibrosis’.

  • limit ([‘integer’, ‘null’]) (optional) Results per page, 1-100. Defaults to 10; invalid values are rejected rather than silently clamped.

  • page ([‘integer’, ‘null’]) (optional) One-based CTIS page number. Defaults to 1; use metadata.next_page while metadata.has_more is true.

Example Usage:

query = {
    "name": "CTIS_search_trials",
    "arguments": {
        "query": "example_value"
    }
}
result = tu.run(query)

CTIS_search_trials_filtered (Type: CTISSearchTrialsTool)#

Structured (filtered) search of the EU Clinical Trials Information System (CTIS) — the European c…

CTIS_search_trials_filtered tool specification

Tool Information:

  • Name: CTIS_search_trials_filtered

  • Type: CTISSearchTrialsTool

  • Description: Structured (filtered) search of the EU Clinical Trials Information System (CTIS) — the European clinical-trials register under the Clinical Trials Regulation. Unlike the free-text CTIS_search_trials, this narrows results with registry filters: medical condition, trial status code, trial phase code, age group code, gender code, has-results flag, sponsor name, therapeutic area, and country/member-state-concerned (MSC) or trial region. Combine filters to count and list precisely matching authorized EU/EEA trials. ‘status’ takes CTIS numeric status codes only (free text such as ‘ongoing’ is rejected): 1=Under evaluation, 2/3/4/5=Authorised (CTIS reports all four as sub-states of ‘Authorised’), 6=Halted, 7=Suspended, 8=Ended, 9=Expired, 10=Revoked, 11=Not authorised, 12=Cancelled. Phase codes are strings like ‘1’,’2’,’3’,’4’. Age group codes: ‘1’=in utero, ‘2’=preterm/newborn through children, ‘3’=adults, ‘4’=elderly (use the CTIS public portal facet for exact codes). No API key required. Pagination is strict and one-based: returns exact total_records plus has_more and next_page; continue with identical filters and limit. Records preserve products, endpoints, detailed dates and age fields.

Parameters:

  • query ([‘string’, ‘null’]) (optional) Optional free-text term applied as CTIS ‘containAll’ (e.g. ‘cancer’, ‘pembrolizumab’). Combine with structured filters below.

  • medical_condition ([‘string’, ‘null’]) (optional) Medical condition / indication filter, e.g. ‘breast cancer’, ‘leukemia’.

  • status ([‘array’, ‘integer’, ‘string’, ‘null’]) (optional) CTIS numeric trial status code(s) – NOT free text. Accepts a single code or a list. Valid codes: 1=Under evaluation, 2/3/4/5=Authorised (CTIS reports these four as sub-states of ‘Authorised’ and publishes no finer label), 6=Halted, 7=Suspended, 8=Ended, 9=Expired, 10=Revoked, 11=Not authorised, 12=Cancelled. Example: [3] or [3, 4]. Any other value is rejected with an error rather than silently returning zero trials.

  • trial_phase_code ([‘array’, ‘string’, ‘null’]) (optional) Trial phase code(s) as strings, e.g. [‘3’] for Phase III. Accepts a single value or a list.

  • age_group_code ([‘array’, ‘string’, ‘null’]) (optional) Age group code(s) as strings, e.g. [‘2’]. Accepts a single value or a list.

  • gender_code ([‘array’, ‘string’, ‘null’]) (optional) Gender code(s) as strings. Accepts a single value or a list.

  • therapeutic_area ([‘array’, ‘string’, ‘null’]) (optional) Therapeutic area code(s). Accepts a single value or a list.

  • has_study_results ([‘boolean’, ‘null’]) (optional) If true, return only trials that have posted study results.

  • sponsor ([‘string’, ‘null’]) (optional) Sponsor name filter, e.g. ‘Pfizer’.

  • sponsor_type_code ([‘array’, ‘string’, ‘null’]) (optional) Sponsor type code(s). Accepts a single value or a list.

  • country ([‘array’, ‘string’, ‘null’]) (optional) Member State Concerned (MSC) country code(s). Accepts a single value or a list (alias for msc).

  • msc ([‘array’, ‘string’, ‘null’]) (optional) Member State Concerned (MSC) code(s). Accepts a single value or a list.

  • trial_region_code ([‘array’, ‘string’, ‘null’]) (optional) Trial region code(s) (e.g. EU/EEA vs partly outside). Accepts a single value or a list.

  • sort_by ([‘string’, ‘null’]) (optional) Optional CTIS sort key (e.g. by decision date).

  • limit ([‘integer’, ‘null’]) (optional) Results per page, 1-100. Defaults to 10; invalid values are rejected rather than silently clamped.

  • page ([‘integer’, ‘null’]) (optional) One-based CTIS page number. Defaults to 1; use metadata.next_page while metadata.has_more is true.

Example Usage:

query = {
    "name": "CTIS_search_trials_filtered",
    "arguments": {
    }
}
result = tu.run(query)