Skip to content
varsome_api
VarSome's high-performance Application Programming Interface (API) enables variant annotation using data from our massive variant knowledge base. You can start your project immediately and without incurring the significant overheads of multiple integrations and manual updates.
VAPI Lander logo
Our Engine Your Workflow
Prog languages

Works with All Programming Languages

VarSome Clinical works with all VCF files and FASTQ files from Illumina, MGI, and Element Biosciences. We also support multi-sample analyses and long-read files from both PacBio and Oxford Nanopore Technologies, providing an all in one solution for NGS tertiary analysis.
annotation graphic

Fast Annotation for WGS & WES

Receive full annotations at >600 variants per second on a normal internet connection. Enabling the allele-frequency filter skips variants with a gnomAD frequency above your chosen threshold, reducing the data processed and increasing throughput up to 4x.
working example

A Working Example

Make use of our reference API client for Python that demonstrates how to annotate a VCF. This reference shows how to structure batched calls and apply the relevant filters to maintain high performance in production. You can clone this repository and adapt the code to suit you.
Why VarSome?

Get germline and somatic classifications returned with full transparency, including the criteria triggered and supporting literature references. The API automates the process but does not remove your control. You decide how results are reviewed, interpreted, and used in your workflow.

VarSome API supports the annotation of SNVs, CNVs, structural variants, and repeat expansions. It works with data from long-read platforms such as PacBio and Oxford Nanopore Technologies, enabling the detection of variants in non-coding or structurally complex regions that may be missed by standard short-read sequencing.

The VarSome API is available in three environments, each designed for different use cases and stability requirements.

The Stable environment is a frozen version with updates released quarterly, suitable for production use. This environment offers high data quality and consistency, but may lag behind the latest updates by up to six months. It is unthrottled and included in all subscriber plans.

The Live environment provides access to the most up-to-date data, including recent user community contributions. It is updated monthly or at our discretion and is ideal for exploratory or flexible use. Like Stable, it is unthrottled and available to subscribers.

The Staging environment mirrors the upcoming Stable release and is intended for testing and validation. It is frozen at least four weeks before a Stable release to allow for compatibility testing. During this time, it may still receive updates if bugs are found. After release, Staging is updated again to reflect Live or internal development versions. Access is throttled and limited to subscribers.

Choosing the right environment helps ensure your integration remains reliable and predictable.

Pricing scales with usage, and you only pay for the data you request. To keep costs low, you can filter by allele frequency, limit to coding or splice-site variants, or select only the annotations you need. High-volume users benefit from lower rates, while monthly caps and dedicated instances are also available

From single-sample clinical interpretation to large-scale cohort annotation, the API scales to match your workload. Submit up to 200 variants in a single request and configure it for high-throughput use with batch processing, smart filtering, and usage cap controls.

Use VarSome’s API to apply consistent interpretation logic across your lab or organisation. Whether centralised or distributed, it ensures reproducible results, alignment with ACMG and AMP guidelines, and up-to-date classification rules in every request.

API Environments to Suit You
1-Sep-24-2025-11-02-09-1921-AM

Stable

A frozen, production-grade API version. It’s updated quarterly and retains high data quality. It may lag behind the live data by up to 6 months.

2-Sep-24-2025-11-02-16-7737-AM

Live

The actively maintained Live environment offers the most up-to-date data and support for community contributions, with updates at VarSome’s discretion.

3-Sep-24-2025-11-02-26-3044-AM

Staging

A test instance reflecting the upcoming Stable release. It’s used for validation before release, may have partial data, and is throttled.

Mentioned 5000+ Times in Literature

Integration of VarSome API in an existing bioinformatic pipeline for automated ACMG interpretation of clinical variants – Sorrentino et al. 2021.

PacMAGI: A pipeline including accurate indel detection for the analysis of PacBio sequencing data applied to RPE65 – Sorrentino et al. 2022.

Variant selection and interpretation: an example of modified VarSome classifier of ACMG guidelines in the diagnostic setting – Cristofoli et al. 2021.

Want to read more? Click here for the list of publications.

VarSome API Plans
VAPI plans 4

Get in Touch for a Personalized Quote