Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Snip is a an API service to link your raw 23&Me data, with a slim version of DbSNP, to return JSON data containing:

  1. Diseases pertaining to your SNPs, and their ClinVar clinical significance labels.
  2. PubMed IDs that support DbSNP's data.
  3. Frequency Studies (i.e. GWAS) that identify how rare the SNP in sample populations (% of study population).

I gave Lightning talk on this API at can find it on youtube here

Your data will be uploaded to a PostgreSQL database in AWS, and only accessible with your username, password and application secret. Requests are authenticated at the app-level with a JWT. User-sensitive information (i.e. 23&Me SNP data) is stored in a table with separate permissions from the rest of the database, and only accessible from 1 endpoint.

Open to ideas on how to build interface(s) for this API, and how to leverage the data collected in an open-source, privacy-friendly fashion!

To install:

python3.6 -m venv env
source env/bin/activate
pip install -r requirements.txt

To upload and get your Snip data:

  1. Download your 23&Me data from their website
  2. Move your 23&Me data file to this directory.
  3. Set the SNIP_API_EMAIL and SNIP_API_PASSWORD env variables to define your credentials. (These will be used in the script below to create an account, and to authorize when you request to get your results)
export SNIP_API_EMAIL='<your email>'
export SNIP_API_PASSWORD='<your password>'
  1. Run the upload client, passing the name of your 23&me file as the first arg:
python <23_and_me_file.txt>
  1. Open the file 23_and_me.json to see your results.


Accessing the Snip REST API with JWT Auth.






No releases published


No packages published