Proteins Variants

curl --request GET \
  --url https://catalog-api-dev.demo.igvf.org/api/proteins/variants

import requests

url = "https://catalog-api-dev.demo.igvf.org/api/proteins/variants"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://catalog-api-dev.demo.igvf.org/api/proteins/variants', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

[
  {
    "name": "<string>",
    "is_complex": true,
    "sequence_variant": "<string>",
    "protein_complex": "<string>",
    "biosample_term": "<string>",
    "biological_context": "<string>",
    "regulatory_type": "<string>",
    "class": "<string>",
    "label": "<string>",
    "method": "<string>",
    "files_filesets": "<string>",
    "source": "<string>",
    "source_url": "<string>",
    "score": 123,
    "neg_log10_pvalue_adj_ref": 123,
    "neg_log10_pvalue_adj_alt": 123,
    "motif": "<string>",
    "motif_log2FC": 123,
    "beta": 123,
    "se": 123,
    "gene": "<string>",
    "gene_consequence": "<string>",
    "neg_log10_pvalue": 123,
    "p_value": 123,
    "neg_log10_pvalue_adj": 123,
    "variant_effect_score": 123,
    "SEMpl_annotation": "<string>",
    "SEMpl_baseline": 123,
    "alt_score": 123,
    "ref_score": 123,
    "relative_binding_affinity": 123,
    "effect_on_binding": "<string>"
  }
]

{
  "message": "<string>",
  "code": "<string>",
  "issues": [
    {
      "message": "<string>"
    }
  ]
}

API Reference

Proteins Variants

Retrieve allele-specific transcription factor binding events from ADASTRA in cell type-specific context,

allele-specific transcription factor binding events from GVATdb, pQTL from UKB by querying proteins, and predicted allele specific binding from SEMpl.

Protein IDs support the following formats: ENSP00000384707.1 or ENSP00000384707 (Ensembl IDs) or P49711-2 (Uniprot ids).

Set verbose = true to retrieve full info on the variant-transcription factor pairs, and the ontology terms of the cell types.

At least one of these fields is required: protein_id, protein_name, uniprot_name, uniprot_full_name, dbxrefs, method, or files_fileset.

The limit parameter controls the page size and can not exceed 100.

Pagination is 0-based.

Examples by method

These examples are grouped by method; use the method filter to return data from a specific method.

ADASTRA:

query by protein identifier

protein_id = ENSP00000281043
method = ADASTRA

GVATdb:

query by protein identifier

protein_id = ENSP00000315417
method = GVATdb

SEMVAR:

query by protein identifier

protein_id = ENSP00000351458
method = SEMVAR

query by files_fileset

Each files_fileset maps to at most one method, so a method filter is usually not necessary.

files_fileset = IGVFFI0005WRQP
method = SEMVAR

pQTL:

query by protein identifier

protein_id = ENSP00000263100
method = pQTL

Proteins Variants

curl --request GET \
  --url https://catalog-api-dev.demo.igvf.org/api/proteins/variants

import requests

url = "https://catalog-api-dev.demo.igvf.org/api/proteins/variants"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://catalog-api-dev.demo.igvf.org/api/proteins/variants', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

[
  {
    "name": "<string>",
    "is_complex": true,
    "sequence_variant": "<string>",
    "protein_complex": "<string>",
    "biosample_term": "<string>",
    "biological_context": "<string>",
    "regulatory_type": "<string>",
    "class": "<string>",
    "label": "<string>",
    "method": "<string>",
    "files_filesets": "<string>",
    "source": "<string>",
    "source_url": "<string>",
    "score": 123,
    "neg_log10_pvalue_adj_ref": 123,
    "neg_log10_pvalue_adj_alt": 123,
    "motif": "<string>",
    "motif_log2FC": 123,
    "beta": 123,
    "se": 123,
    "gene": "<string>",
    "gene_consequence": "<string>",
    "neg_log10_pvalue": 123,
    "p_value": 123,
    "neg_log10_pvalue_adj": 123,
    "variant_effect_score": 123,
    "SEMpl_annotation": "<string>",
    "SEMpl_baseline": 123,
    "alt_score": 123,
    "ref_score": 123,
    "relative_binding_affinity": 123,
    "effect_on_binding": "<string>"
  }
]

{
  "message": "<string>",
  "code": "<string>",
  "issues": [
    {
      "message": "<string>"
    }
  ]
}

Query Parameters

protein_id

string

protein_name

string

uniprot_name

string

uniprot_full_name

string

dbxrefs

string

label

enum<string>

Available options:

allele-specific binding,

pQTL,

predicted allele-specific binding

source

enum<string>

Available options:

ADASTRA,

GVATdb,

IGVF,

UKB

method

enum<string>

Available options:

ADASTRA,

GVATdb,

SEMVAR,

pQTL

files_fileset

string

name

enum<string>

Available options:

binding modulated by,

level associated with

organism

enum<string>

default:Homo sapiens

Available options:

Homo sapiens

verbose

enum<string>

default:false

Available options:

true,

false

page

number

default:0

limit

number

Response

Successful response

name

string

required

is_complex

boolean

required

sequence_variant

protein_complex

biosample_term

biological_context

string | null

regulatory_type

string | null

class

string | null

label

string | null

method

string | null

files_filesets

string | null

source

string | null

source_url

string | null

score

number | null

neg_log10_pvalue_adj_ref

number | null

neg_log10_pvalue_adj_alt

number | null

motif

string | null

motif_log2FC

number | null

beta

number | null

gene

string | null

gene_consequence

string | null

neg_log10_pvalue

number | null

p_value

number | null

neg_log10_pvalue_adj

number | null

variant_effect_score

number | null

SEMpl_annotation

string | null

SEMpl_baseline

number | null

alt_score

number | null

ref_score

number | null

relative_binding_affinity

number | null

effect_on_binding

string | null

Proteins Motifs Proteins Proteins

Overview

Endpoints

Proteins Variants

Query Parameters

Response