On Friday 2nd April 2021 (morning, CET), the Stable VarSome API will be updated from version 8.4.16 to 9.1.8. This release only affects users of the Stable API service, and does not affect VarSome.com, VarSome Premium or VarSome Clinical users. We strongly recommend you review these changes and test your code against the Staging API, where the changes for this release are already deployed for immediate review. Learn more about VarSome API Environments and release schedules.
Below you may find all the changes since the last release (8.4.16 in Nov 2020), that could affect your usage of the VarSome API. There are no major API changes, but some changes to how data is presented:
Please contact us if you need further details on this data representation change, it is very similar to how the data is displayed in VarSome:
We have added a number of new databases related to cancer. These databases can be large and we strongly recommend that users refrain from using “add-all-data=1” as this will incur significant additional costs and instead explicitly list any additional databases required above the ones used by ACMG (which are automatically added if add-ACMG-annotation==1).
In this example we annotate with the minimum databases required by ACMG, but add BRAVO & Kaviar data too:
(these examples require an authorised API token to work).
ANP classification is currently only available in the Live API with the flag “add-AMP-annotation=1” ( this also enables ACMG). Inline with our release protocol, AMP classification will not be available for users of the Stable API for another 3 months. Learn more about VarSome's Implementation of AMP Guidelines.
Here we request the new AMP cancer annotation for TP53:R273H, which pulls in data from cBioPortal, Cancer HotSpots amongst others:
Note that the full ACMG annotation has been included too along with all the databases required for both AMP & ACMG classification.
The previous Stable API contained data as of 20th November 2020.
This new version will contain a snapshot of the Live database as of the 12th Feb 2021.
Source |
Current Stable Version |
New Version |
ClinVar |
09-Nov-2020 |
18-Jan-2021 |
UniProt Variants |
10-Nov-2020 |
21-Dec-2020 |
UniProt Regions |
11-Nov-2020 |
22-Jan-2021 |
DECIPHER |
11-Nov-2020 |
12-Jan-2021 |
CIViC |
11-Nov-2020 |
12-Jan-2021 |
GWAS |
11-Nov-2020 |
13-Jan-2021 |
PanelApp |
12-Nov-2020 |
12-Jan-2021 |
RefSeq |
203 |
204 |
AACT |
10-Nov-2020 |
12-Jan-2021 |
GDC |
27 |
09-Dec-2020 (27 refactored) |
CPIC |
12-Nov-2020 |
13-Jan-2021 |
PharmGKB |
27-Apr-2020 |
13-Dec-2020 |
IARC TP53 Germline |
release 19 |
release 20 (refactored) |
IARC TP53 Somatic |
release 19 |
release 20 (refactored) |
ICGC Somatic |
release 28 |
release 28 (refactored) |
HGNC |
18-Nov-2020 |
18-Jan-2021 |
An overview of the VarSome API is available here with more detailed information here.
Please contact us at the usual address support@varsome.com should you require any additional information or run into any major issues. As ever we look forward to your feedback and suggestions to improve our platform.