| Note: Unlike other endpoints, the exports for this endpoint are not JSON formatted. They are the same formats as provided by the frontend search export function: csv, sdf, xlsx. |
GET /api/v1/vaults/<vault_id>/searches/<search_id>Unlike other calls, saved searches can only be performed asynchronously.
Returns an export id and status. See Async Exports for how to check on the status of your call and retrieving the data once it has finished.
Query Parameters (all optional):
projects |
Comma separated list of ids The projects to search |
data_sets |
Comma separated list of ids The data sets to search |
| zip |
One of the following: true |
format |
Defaults to csv One of the following: |
GET /api/v1/vaults/<vault_id>/searches
Examples
curl -H "X-CDD-Token: $TOKEN" https://app.collaborativedrug.com/api/v1/vaults/489978881/searches/97374743?projects=938429932&format=sdf
Returns:
{
"status": "new",
"id": 8
}curl -H "X-CDD-Token: $TOKEN" https://app.collaborativedrug.com/api/v1/vaults/489978881/searches
Returns a list of accessible saved searches for the given vault along with the criteria which make up that search. Available criteria and a sample response are listed below:
"name": "TPP",
"id": 1234567,
"projects": [
{
"name": "Lead Compounds",
"id": 12345
}
],
"owner": "User1",
"search_criteria": {
"structure": "\r\nGenerated by WebMolKit\r\n\r\n 0 0 0 0 0 999 V3000\r\nM V30 BEGIN CTAB\r\nM V30 COUNTS 6 6 0 0 1\r\nM V30 BEGIN ATOM\r\nM V30 1 C 17.3398 -14.4505 0.0000 0\r\nM V30 2 C 19.9352 -14.4498 0.0000 0\r\nM V30 3 C 18.6400 -13.7003 0.0000 0\r\nM V30 4 C 19.9352 -15.9512 0.0000 0\r\nM V30 5 C 17.3398 -15.9579 0.0000 0\r\nM V30 6 C 18.6432 -16.7004 0.0000 0\r\nM V30 END ATOM\r\nM V30 BEGIN BOND\r\nM V30 1 2 3 1\r\nM V30 2 1 1 5\r\nM V30 3 2 5 6\r\nM V30 4 1 6 4\r\nM V30 5 2 4 2\r\nM V30 6 1 2 3\r\nM V30 END BOND\r\nM V30 END CTAB\r\nM END",
"structure_registration_type": "structure",
"structure_search_type": "substructure",
"sort_direction": "DESC",
"molecule_criteria": [
{
"query": "Molecule1\r\nMolecule2\r\nMolecule3\r\nMolecule4",
"junction": "AND",
"query_style": "has",
"data_type_name": "Text"
}
],
"collection_criteria": [
{
"collection_id": 123456,
"junction": "AND",
"not_in": false
}
],
"protocol_criteria": [
{
"protocol_id": 12345,
"run_criterion": "run_id",
"run_id": 123456,
"negated": false,
"junction": "AND",
"criterion_type": "data set or protocol"
}
],
"structure_criterion": {
"cd_molweight_minimum": 100.0,
"cd_molweight_maximum": 800.0
}
},
"display_criteria": {
"row_detail_level": "readout_row",
"show_all_protocol_data": false,
"show_non_matching_readouts": false,
"show_dose_response_legend": false,
"plot_scale_type": "protocol_settings",
"image_size": "large",
"max_column_width": 25
},
"saved_search_session_id": 123456,
"visualization_session_id": 54321,
"last_ui_run_at": "2026-02-10T13:56:26Z",
"last_api_run_at": null,
"executed_by": [
"User1"
]
},
Explanation of Search criteria:
-
"structure"- Any structure or sequence included in the saved search. -
"structure_registration_type"They registration type for that structure - structure, nucleotide_sequence, amino_acid_sequence -
"structure_search_type"substructure, exact, or similarity -
"structure_similarity_threshold"If "structure_search_type" = similarity, this will be the similarity % -
"molecule_criteria"- Search terms entered in the Keyword search -
"collection_criteria"- Collection(s) included in the saved search -
"protocol_criteria"- Protocol, Run, and Protocol hit criteria used in the saved search-
"run_criterion"- "run_criterion": "run_id", "run_id": 123456 shows a specific run or a list of specific runs
- "run_criterion": "any" shows any run in the protocol
- "run_criterion": "run_date", "run_after": "2023-03-27" shows any run after that date
- "run_after": "2023-03-27" can be included to do a date range
- "run_criterion": "recent", "since_days_ago": 90 would get data from runs in the last 90 days
- negated refers to the In/Not In option in the UI
- "junction": "AND" is the operator for each protocol search parameter in the UI
-
-
"structure_criterion"- CDD Vault generated structure/sequence properties used in the saved search. Here are all of the available properties:
amino_acid_sequence_molecular_weight_maximum
amino_acid_sequence_molecular_weight_minimum
amino_acid_sequence_percent_hydrophilic_maximum
amino_acid_sequence_percent_hydrophilic_minimum
amino_acid_sequence_percent_hydrophobic_maximum
amino_acid_sequence_percent_hydrophobic_minimum
amino_acid_sequence_seq_length_maximum
amino_acid_sequence_seq_length_minimum
bbb2_score_maximum
bbb2_score_minimum
cd_molweight_maximum
cd_molweight_minimum
cns_mpo_score_maximum
cns_mpo_score_minimum
exact_mass_maximum
exact_mass_minimum
fsp3_maximum
fsp3_minimum
heavy_atom_count_maximum
heavy_atom_count_minimum
log_d_maximum
log_d_minimum
log_p_maximum
log_p_minimum
log_s_maximum
log_s_minimum
nucleotide_sequence_at_content_maximum
nucleotide_sequence_at_content_minimum
nucleotide_sequence_gc_content_maximum
nucleotide_sequence_gc_content_minimum
nucleotide_sequence_molecular_weight_maximum
nucleotide_sequence_molecular_weight_minimum
nucleotide_sequence_seq_length_maximum
nucleotide_sequence_seq_length_minimum
num_aromatic_rings_maximum
num_aromatic_rings_minimum
num_h_bond_acceptors_maximum
num_h_bond_acceptors_minimum
num_h_bond_donors_maximum
num_h_bond_donors_minimum
num_rotatable_bonds_maximum
num_rotatable_bonds_minimum
num_rule_of_5_violations_maximum
num_rule_of_5_violations_minimum
p_k_a_maximum
p_k_a_minimum
topological_polar_surface_area_maximum
topological_polar_surface_area_minimum-
"display_criteria"- The columns of data and display options that are displayed in the saved search (customize your report). -
"last_ui_run_at"The last time that the search was executed by a user via the UI -
"last_api_run_at"The last time that the search was executed by a user via the API -
"executed_by"A list of users who have executed the search
See Molecule(s) [GET, POST, PUT] and Batch(es) [GET, POST, PUT] for how many of these Search Criteria can be used to search directly for Molecules and Batches.