Endpoints

Endpoints

The base-url needs to be supplemented with a suffix (path) to the resource. The base url and path together form the endpoint. All API endpoints are listed below.

Please note that the root url ("/") is not a valid endpoint and will thus result in a 404 (Not Found) error.


Model List Endpoints

Endpoints that result in a list of models

/models

List of all models.

/samples/<sample_id>/models

A list of models that originate from a specific sample

Example: /samples/SIDS00002/models

/patients/<patient_id>/models

A list of models from a particular patient
Example: /patients/SIDP00003/models

/models/by_<mut_type>/<gene_identifier>

A list of models that have a mutation type in a specific gene.
Valid <mut_type>s are 'frameshift', 'snp', 'insertion', 'deletion', 'splice_variant' or 'mutation'. Use 'mutation' to list models with any kind of mutation in the specified gene.
Example: /models/by_snp/BRAF
Example: /models/by_frameshift/TP53

/models/by_<mut_type>/<gene_identifier>/<variant>

A list of models that have a mutation type in a specific protein location in a specific gene.
Example: /models/by_snp/BRAF/V600 - for any model with a BRAF mutation at the V600 location
Example: /models/by_snp/BRAF/V600E - for any model with a BRAF V660E mutation


Single Model Endpoints

Endpoints that result in a single model.

/models/<id>

Example /models/SIDM00003

/models/<source>/<source_id>

Use any identifier that is annotated. The identifier source is case-insensitive, but the identifier is case-sensitive.
Example: /models/cosmic_id/909751
Example: /models/CCLE_ID/769P_KIDNEY

/models/<model_id>/files

/models/<source>/<source_id>/files

View a list of all files attached to a model


Gene List Endpoints

Endpoints that show a list genes

/genes

List of all genes in database


Mutations & Cancer Drivers

/models/<model_id>/datasets/mutations

/models/<source>/<source_id>/datasets/mutations

All mutations for a specific model.
Example: /models/SIDM00003/datasets/mutations
Example: /models/COSMIC_ID/905975/datasets/mutations

/models/<model_id>/datasets/cancer_drivers

/models/<source>/<source_id>/datasets/cancer_drivers

Cancer driver mutations for a specific model.

/models/<model_id>/datasets/cancer_drivers/by_<category>

/models/<source>/<source_id>/datasets/cancer_drivers/by_<category>

Cancer drivers of a specific model, ranked by how often they occur in a specific <category>.
Example: /models/SIDM00002/datasets/cancer_drivers/by_tissue - shows all drivers for model SIDM00002, ranked by how often they occur in its tissue.


Copy Number Variation

/models/<model_id>/datasets/genecnv

/models/<source>/<source_id>/datasets/genecnv

Gene level CNV of a specific model