On 5 September 2025 we will be releasing the Q3 API changes for the VarSome API (stable-api.varsome.com).

The Stable API will update version 13.4.0 to version 13.8.0 with data frozen as of the 1 August 2025. This version has been successfully used in production for over a month.

The most recent version, used by VarSome itself, is always available at api.varsome.com.

Database Updates

The following databases have been updated:

JSON Schema Changes

Variants

POST /lookup/batch/{ref_genome}

Updated

•  removed the optional property 'regions/gnomad_sv/items' from the response with the '201' status
•  removed the optional property 'regions/gnomad_sv/version' from the response with the '201' status
• added the optional property 'dbnsfp/items/clinpred_pred' to the response with the '201' status
• added the optional property 'dbnsfp/items/clinpred_rankscore' to the response with the '201' status
• added the optional property 'dbnsfp/items/clinpred_score' to the response with the '201' status
• added the optional property 'dbnsfp/items/esm1b_converted_rankscore' to the response with the '201' status
• added the optional property 'dbnsfp/items/esm1b_pred' to the response with the '201' status
• added the optional property 'dbnsfp/items/esm1b_score' to the response with the '201' status
• added the optional property 'dbnsfp/items/gmvp_rankscore' to the response with the '201' status
• added the optional property 'dbnsfp/items/gmvp_score' to the response with the '201' status
• added the optional property 'dbnsfp/items/mutpred2_pred' to the response with the '201' status
• added the optional property 'dbnsfp/items/mutpred2_rankscore' to the response with the '201' status
• added the optional property 'dbnsfp/items/mutpred2_score' to the response with the '201' status
• added the optional property 'dbnsfp/items/phactboost_rankscore' to the response with the '201' status
• added the optional property 'dbnsfp/items/phactboost_score' to the response with the '201' status
• added the optional property 'dbnsfp/items/varity_er_loo_rankscore' to the response with the '201' status
• added the optional property 'dbnsfp/items/varity_er_loo_score' to the response with the '201' status
• added the optional property 'dbnsfp/items/varity_er_rankscore' to the response with the '201' status
• added the optional property 'dbnsfp/items/varity_er_score' to the response with the '201' status
• added the optional property 'dbnsfp/items/varity_r_loo_rankscore' to the response with the '201' status
• added the optional property 'dbnsfp/items/varity_r_loo_score' to the response with the '201' status
• added the optional property 'dbnsfp/items/varity_r_rankscore' to the response with the '201' status
• added the optional property 'dbnsfp/items/varity_r_score' to the response with the '201' status
• added the optional property 'knc_splice_vault' to the response with the '201' status

GET /lookup/{spec_query}/{ref_genome}

Updated

•  removed the optional property 'regions/gnomad_sv/items' from the response with the '200' status
•  removed the optional property 'regions/gnomad_sv/version' from the response with the '200' status
• added the new enum value 'knc-splice-vault' to the 'query' request parameter 'add-source-databases'
• added the new enum value 'knc-splice-vault' to the 'query' request parameter 'exclude-source-databases'
• added the optional property 'dbnsfp/items/clinpred_pred' to the response with the '200' status
• added the optional property 'dbnsfp/items/clinpred_rankscore' to the response with the '200' status
• added the optional property 'dbnsfp/items/clinpred_score' to the response with the '200' status
• added the optional property 'dbnsfp/items/esm1b_converted_rankscore' to the response with the '200' status
• added the optional property 'dbnsfp/items/esm1b_pred' to the response with the '200' status
• added the optional property 'dbnsfp/items/esm1b_score' to the response with the '200' status
• added the optional property 'dbnsfp/items/gmvp_rankscore' to the response with the '200' status
• added the optional property 'dbnsfp/items/gmvp_score' to the response with the '200' status
• added the optional property 'dbnsfp/items/mutpred2_pred' to the response with the '200' status
• added the optional property 'dbnsfp/items/mutpred2_rankscore' to the response with the '200' status
• added the optional property 'dbnsfp/items/mutpred2_score' to the response with the '200' status
• added the optional property 'dbnsfp/items/phactboost_rankscore' to the response with the '200' status
• added the optional property 'dbnsfp/items/phactboost_score' to the response with the '200' status
• added the optional property 'dbnsfp/items/varity_er_loo_rankscore' to the response with the '200' status
• added the optional property 'dbnsfp/items/varity_er_loo_score' to the response with the '200' status
• added the optional property 'dbnsfp/items/varity_er_rankscore' to the response with the '200' status
• added the optional property 'dbnsfp/items/varity_er_score' to the response with the '200' status
• added the optional property 'dbnsfp/items/varity_r_loo_rankscore' to the response with the '200' status
• added the optional property 'dbnsfp/items/varity_r_loo_score' to the response with the '200' status
• added the optional property 'dbnsfp/items/varity_r_rankscore' to the response with the '200' status
• added the optional property 'dbnsfp/items/varity_r_score' to the response with the '200' status
• added the optional property 'knc_splice_vault' to the response with the '200' status

Genes

No changes.

CNVs

# API Changelog 11.22.1 vs. 11.24.0

## GET /cnv/{query}/{ref_genome}

- :warning: removed the optional property 'regions/gnomad_sv/items' from the response with the '200' status

- :warning: removed the optional property 'regions/gnomad_sv/version' from the response with the '200' status

Please contact us if you need any further assistance with this release.