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

The Stable API will update version 13.8.0 to version 13.12.2 with data frozen as of the
7 November 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}

- :warning: the 'wustl_civic/items/items/items/molecular_profiles/items/molecular_profile/variant/items/variant_ids/items/' response's property type/format changed from 'integer'/'' to 'string'/'' for status '201'

## GET /lookup/{spec_query}/{ref_genome}

- :warning: the 'wustl_civic/items/items/items/molecular_profiles/items/molecular_profile/variant/items/variant_ids/items/' response's property type/format changed from 'integer'/'' to 'string'/'' for status '200'

-  added the new enum value 'gnomad-str' to the 'query' request parameter 'add-source-databases'

-  added the new enum value 'gnomad-str' to the 'query' request parameter 'exclude-source-databases'

Genes

## GET /gene/{gene_symbol}/{ref_genome}

- :warning: the response property 'jax_ckb/version' became optional for the status '200'

- :warning: removed the optional property 'ebi_gene_2_phenotype/items/items/organs' from the response with the '200' status

## POST /genes/batch/{ref_genome}

- :warning: the response property 'jax_ckb/version' became optional for the status '201'

- :warning: removed the optional property 'ebi_gene_2_phenotype/items/items/organs' from the response with the '201' status

CNVs

No changes.

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