API

The same data by URL, for scripts: start with three requests, then look up an endpoint.

Data release 2026.11. Every card has a live Try it; positions are 1-based.

Start here

Three real requests, each run live below. No key is needed.

1

Find the protein

Type what you know. The answer carries the GENCODE accession.

curl -s 'https://discanvis.elte.hu/find/suggest?q=RAF1'
/find/suggest?q=RAF1
All parameters
2

Read one layer

Pfam domains of RAF1-201, as tab-separated text.

curl -s 'https://discanvis.elte.hu/rest/RAF1-201/pfam'
/rest/RAF1-201/pfam
All parameters
3

Read its variants

ClinVar and TCGA missense variants in residues 250 to 265.

curl -s -G 'https://discanvis.elte.hu/rest/RAF1-201/250-265.json' \
  --data-urlencode 'annotations=["clinvar","tcgam"]'
/rest/RAF1-201/250-265.json?annotations=["clinvar","tcgam"]
All parameters

How answers look

IdentifierThe GENCODE protein accession, as in a Summary URL (RAF1-201). /rest/ and /download/ also take a gene symbol, a UniProt accession or an Ensembl transcript with search_type; a gene with several isoforms answers with its main isoform.
Positions1-based and inclusive, on the protein sequence. The one exception is the pdb layer of /rest/: its spans are 0-based (Summary shifts them by one).
ReleaseEvery JSON answer of /rest/ has a meta block: api_version, generated and release (data release 2026.11, genome, link to the source list). Cite the release with the data you use.
Errors/rest/ answers a wrong protein, layer or range with HTTP 200: a text message, or an error key in the JSON. Look for it. The other endpoints use HTTP 400, 404 or 503 with an error key.
Stability/rest/, /download/ and /api/v1/ are the documented interfaces. Protein reports are what the pages draw and can change with them: read the field you need by name.
UseNo key, no registration. Ask for one protein, region or residue at a time; for the whole proteome use Downloads. Everything here is read-only.

Find a protein

Turn a name you have into the protein identifier the rest of the API takes.

GET /find/suggest

Search suggestions

What the search box offers for what you typed: where it would go (intent) and grouped suggestions.

Parameters
NameInDescription
qquery · requiredA gene, accession, variant, GO term, disease or a sentence.
Example request https://discanvis.elte.hu/find/suggest?q=RAF1
curl -s 'https://discanvis.elte.hu/find/suggest?q=RAF1'
Example response · abridged, RAF1-201
{"intent": {"kind": "protein", "label": "Open RAF1 in Summary", "url": "/summary/RAF1-201/",
            "recognised": "the protein RAF1", "resolved": "RAF1 → RAF1-201 · P04049"},
 "groups": [{"title": "Proteins",
             "items": [{"label": "RAF1", "hint": "RAF1-201 · P04049", "url": "/summary/RAF1-201/"}]}]}

/find?q=… is the same lookup as a redirect (HTTP 302) to the page that answers it; a script should read this endpoint and take the accession from intent.url. An empty q answers {"intent": null, "groups": []}.

Try it
/find/suggest

Read a protein

One protein: every layer, one layer, one region or one residue. Positions are 1-based.

GET /rest/{id}.{format}

A whole protein

Every layer for one protein: JSON (a meta block and one key per layer), tab-separated text, or FASTA.

Parameters
NameInDescription
idpath · requiredThe protein, as named by search_type.
formatpath · requiredjson, txt (one #layer section per layer) or fasta (>accession|UniProt|transcript|gene).
search_typequeryWhat id is: empty = GENCODE protein accession (RAF1-201); gene_name (RAF1), uniprot (P04049) or transcript (ENST00000251849.9). A gene with several isoforms answers with its main isoform.
Example request https://discanvis.elte.hu/rest/RAF1-201.json
curl -s 'https://discanvis.elte.hu/rest/RAF1-201.json'
Example response · abridged, RAF1-201
{"meta": {"api_version": "1", "generated": "2026-11-17T07:19:34+00:00",
  "release": {"data_release": "2026.11", "released": "2026-11-16", "genome": "GRCh38, GENCODE v44", …},
  "accession": "RAF1-201"},
 "protein": [{"Protein ID": "RAF1-201", …}],
 "exon": [{"exon_number": 1, "start": 70, "end": 107}, …],
 "phastcons": …, "clinvar": [{"Mutation": "L101R", "Disease": "not provided", …}, …],
 "pfam": [{"alignment_start": 57, "alignment_end": 128, "hmm_name": "RBD", …}, …],
 "tcgam": {"mutations": {"S257L": 11, …}, "cancertypes": {"SKCM": 5, …}},
 … one key per layer (about 40); a layer with no rows is null}

Large: the JSON of RAF1-201 is about 1.6 MB. Read one layer, region or residue when you can. A layer with no rows is null. pdb spans are 0-based here (Summary shifts them by one).

Try it
/rest/{id}.{format}
GET /rest/{id}/{layer}

One layer

One layer of one protein as tab-separated text; the first column is a row number.

Parameters
NameInDescription
idpath · requiredThe protein, as named by search_type.
layerpath · requiredA layer name from the table at the foot of the page.
search_typequeryWhat id is: empty = GENCODE protein accession (RAF1-201); gene_name (RAF1), uniprot (P04049) or transcript (ENST00000251849.9). A gene with several isoforms answers with its main isoform.
Example request https://discanvis.elte.hu/rest/RAF1-201/pfam
curl -s 'https://discanvis.elte.hu/rest/RAF1-201/pfam'
Example response · abridged, RAF1-201
	Protein ID	alignment_start	alignment_end	envelope_start	envelope_end	hmm_acc	hmm_name	type	…
0	RAF1-201	351	605	349	606	PF07714.20	PK_Tyr_Ser-Thr	Domain	…
1	RAF1-201	139	186	139	187	PF00130.25	C1_1	Domain	…
2	RAF1-201	57	128	57	129	PF02196.18	RBD	Domain	…

The answer is text wrapped in <pre>. A wrong layer or protein is still HTTP 200, with the message as the text (the list of valid layers, or Not valid Protein ID).

Try it
/rest/{id}/{layer}
GET /rest/{id}/{start}-{end}.{format}

One region

The layers inside residues start to end (1-based, inclusive).

Parameters
NameInDescription
idpath · requiredThe protein, as named by search_type.
startpath · requiredFirst residue.
endpath · requiredLast residue; not beyond the sequence length.
formatpath · requiredjson, or txt for tab-separated text.
annotationsqueryA JSON list of the layers to keep, e.g. ["clinvar","tcgam"]; empty = every layer. Only the layers marked yes under Layer names exist for a region or residue. The disorder layers answer under one key, Disordered.
search_typequeryWhat id is: empty = GENCODE protein accession (RAF1-201); gene_name (RAF1), uniprot (P04049) or transcript (ENST00000251849.9). A gene with several isoforms answers with its main isoform.
Example request https://discanvis.elte.hu/rest/RAF1-201/250-265.json?annotations=["clinvar","tcgam"]
curl -s -G 'https://discanvis.elte.hu/rest/RAF1-201/250-265.json' \
  --data-urlencode 'annotations=["clinvar","tcgam"]'
Example response · abridged, RAF1-201
{"meta": {"api_version": "1", "generated": "2026-11-17T07:19:34+00:00",
  "release": {"data_release": "2026.11", "released": "2026-11-16", "genome": "GRCh38, GENCODE v44", …},
  "accession": "RAF1-201"},
 "protein": {"Protein ID": "RAF1-201", "UniProt Accession": "P04049", "Gene Name": "RAF1",
  "Transcript ID": "ENST00000251849.9", "Chromosome": "chr3", "Cancer Driver": "Census, Compendium", …},
 "clinvar": [{"Mutation": "H264L", "Disease": "Cardiovascular phenotype|RASopathy|not provided",
              "RCVaccession": "RCV000816240|…", "dbSNP": "", "MIMID": "-"}, …],
 "tcgam": {"mutations": {"S257L": 11, "S259F": 2, "P261R": 1, …},
           "cancertypes": {"SKCM": 5, "COAD": 4, "LUAD": 4, …}}}

A bad id, a range past the sequence or start after end is HTTP 200 with an error key (and meta): look for it.

Try it
/rest/{id}/{start}-{end}.{format}
GET /rest/{id}/{position}.{format}

One residue

The layers at one residue (1-based).

Parameters
NameInDescription
idpath · requiredThe protein, as named by search_type.
positionpath · requiredThe residue.
formatpath · requiredjson, or txt for tab-separated text.
annotationsqueryA JSON list of the layers to keep, e.g. ["clinvar","tcgam"]; empty = every layer. Only the layers marked yes under Layer names exist for a region or residue. The disorder layers answer under one key, Disordered.
search_typequeryWhat id is: empty = GENCODE protein accession (RAF1-201); gene_name (RAF1), uniprot (P04049) or transcript (ENST00000251849.9). A gene with several isoforms answers with its main isoform.
Example request https://discanvis.elte.hu/rest/RAF1-201/257.json?annotations=["clinvar","tcgam","pfam"]
curl -s -G 'https://discanvis.elte.hu/rest/RAF1-201/257.json' \
  --data-urlencode 'annotations=["clinvar","tcgam","pfam"]'
Example response · abridged, RAF1-201
{"meta": {"api_version": "1", "generated": "2026-11-17T07:19:34+00:00",
  "release": {"data_release": "2026.11", "released": "2026-11-16", "genome": "GRCh38, GENCODE v44", …},
  "accession": "RAF1-201"},
 "protein": {"Protein ID": "RAF1-201", "UniProt Accession": "P04049", "Gene Name": "RAF1",
  "Transcript ID": "ENST00000251849.9", "Chromosome": "chr3", "Cancer Driver": "Census, Compendium", …},
 "clinvar": [{"Mutation": "S257P", "Disease": "not provided|RASopathy|Noonan syndrome|…", …},
             {"Mutation": "S257L", …}, …],
 "tcgam": {"mutations": {"S257L": 11, "S257W": 1}, "cancertypes": {"COAD": 4, "SKCM": 3, …}},
 "pfam": null}

Errors come the same way as for a region: HTTP 200 with an error key. annotations=["roisig"] is not usable here: that name is answered with the disorder layers.

Try it
/rest/{id}/{position}.{format}

The same, as a file

The /rest/ answers with a download header, for a browser or wget.

GET /download/{id}.{format}

A whole protein, as a file

The same answer as /rest/{id}.{format}, with a Content-Disposition header that saves it.

Parameters
NameInDescription
idpath · requiredThe protein, as named by search_type.
formatpath · requiredjson, txt or fasta.
search_typequeryWhat id is: empty = GENCODE protein accession (RAF1-201); gene_name (RAF1), uniprot (P04049) or transcript (ENST00000251849.9). A gene with several isoforms answers with its main isoform.
Example request https://discanvis.elte.hu/download/RAF1-201.fasta
curl -s 'https://discanvis.elte.hu/download/RAF1-201.fasta'
Example response · abridged, RAF1-201
HTTP/1.1 200 OK
Content-Type: application/json
Content-Disposition: attachment; filename=RAF1-201.json

{"meta": {…}, "protein": [{"Protein ID": "RAF1-201", …}], …}

Saves RAF1-201.json, .txt or .fasta.

Try it
/download/{id}.{format}
GET /download/{id}/{layer}

One layer, as a file

One layer as a tab-separated file with a header row (no row-number column).

Parameters
NameInDescription
idpath · requiredThe protein, as named by search_type.
layerpath · requiredA layer name from the table at the foot of the page.
search_typequeryWhat id is: empty = GENCODE protein accession (RAF1-201); gene_name (RAF1), uniprot (P04049) or transcript (ENST00000251849.9). A gene with several isoforms answers with its main isoform.
Example request https://discanvis.elte.hu/download/RAF1-201/pfam
curl -s 'https://discanvis.elte.hu/download/RAF1-201/pfam'
Example response · abridged, RAF1-201
HTTP/1.1 200 OK
Content-Disposition: attachment; filename=RAF1-201_Pfam.tsv

Protein ID	alignment_start	alignment_end	envelope_start	…
RAF1-201	351	605	349	…

Saves RAF1-201_Pfam.tsv. A wrong layer is HTTP 200 with the message as the text.

Try it
/download/{id}/{layer}
GET /download/{id}/{position}.{format}

One residue, as a file

The same answer as /rest/{id}/{position}.{format}, as a saved file.

Parameters
NameInDescription
idpath · requiredThe protein, as named by search_type.
positionpath · requiredThe residue.
formatpath · requiredjson or txt.
annotationsqueryA JSON list of the layers to keep, e.g. ["clinvar","tcgam"]; empty = every layer. Only the layers marked yes under Layer names exist for a region or residue. The disorder layers answer under one key, Disordered.
search_typequeryWhat id is: empty = GENCODE protein accession (RAF1-201); gene_name (RAF1), uniprot (P04049) or transcript (ENST00000251849.9). A gene with several isoforms answers with its main isoform.
Example request https://discanvis.elte.hu/download/RAF1-201/257.json?annotations=["clinvar","tcgam","pfam"]
curl -s -G 'https://discanvis.elte.hu/download/RAF1-201/257.json' \
  --data-urlencode 'annotations=["clinvar","tcgam","pfam"]'
Example response · abridged, RAF1-201
HTTP/1.1 200 OK
Content-Type: application/json
Content-Disposition: attachment; filename=RAF1-201_257.json

{"meta": {…}, "protein": {"Protein ID": "RAF1-201", …}, "clinvar": […], …}

Residues only: there is no region download (/download/…/250-265.json is a server error). Use /rest/ for a region.

Try it
/download/{id}/{position}.{format}

Variants you bring

Place a genomic variant on proteins, and read a protein variant against its residue.

GET /api/genome/resolve/

Genomic variant to protein

A genomic variant or identifier placed on the proteins it falls in (GRCh37 or GRCh38).

Parameters
NameInDescription
qquery · requiredOne item: an rsID, a gnomAD or VCF id (7-140753336-A-T), an HGVS g. / c. / p. name, an SPDI or a ClinVar VCV / RCV id.
buildqueryauto (detected), GRCh38 or GRCh37.
Example request https://discanvis.elte.hu/api/genome/resolve/?q=7-140753336-A-T&build=auto
curl -s 'https://discanvis.elte.hu/api/genome/resolve/?q=7-140753336-A-T&build=auto'

# several at once
curl -s -X POST 'https://discanvis.elte.hu/api/genome/resolve/' \
  -H 'Content-Type: application/json' \
  -d '{"items": ["7-140753336-A-T"], "build": "GRCh38"}'

POST {"items": [...], "build": "GRCh38"} takes up to 500 items.

Example response · abridged, RAF1-201
{"ok": true, "build_requested": "auto", "detection": null,
 "answers": [{"status": "ok", "notation": "genomic", "build": "hg38", "input": "7-140753336-A-T",
              "alleles": [{"chrom": "chr7", "pos": 140753336, "ref": "A", "alt": "T"}],
              "hits": [{"protein_id": "BRAF-220", "gene": "BRAF", "label": "V600E",
                        "consequence": "missense", "start": 600, "end": 600, "strand": "-",
                        "ref_ok": true, "main_isoform": true, "mane_select": true}]}]}

An empty q or more than 500 items is HTTP 400 with {"ok": false, "error": …}; a missing genome map is 503.

Try it
/api/genome/resolve/
POST /analysis/api/upload/interpret/

Read a variant against its residue

One protein variant read against its residue: the evidence, a germline reading (ACMG/AMP) and a somatic reading, never combined.

Parameters
NameInDescription
protein_idbody · requiredGENCODE accession (RAF1-201).
positionbody · requiredResidue, 1-based.
labelbodyThe change, e.g. S257L; the reference residue is checked against the sequence.
rowsbodyInstead of the three above: a list of {protein_id, position, label}, up to 1 000.
Example request
curl -s -X POST 'https://discanvis.elte.hu/analysis/api/upload/interpret/' \
  -H 'Content-Type: application/json' \
  -d '{
  "protein_id": "RAF1-201",
  "position": 257,
  "label": "S257L"
}'
Example response · abridged, RAF1-201
{"ok": true, "protein_id": "RAF1-201", "gene": "RAF1", "position": 257, "label": "S257L",
 "kind": "missense", "wild_type": "S", "alt": "L",
 "site": {…}, "motifs": {…}, "clinvar": {…}, "cancer": {…}, "gnomad": {…}, "predictors": {…},
 "acmg": {"code": "LP", "label": "Likely pathogenic",
          "rule": "1 strong, 1 moderate, 2 supporting pathogenic criteria → Likely pathogenic", …},
 "oncogenicity": {"code": "LO", "label": "Likely oncogenic", "points": 8,
                  "rule": "OP4 +1 OP1 +1 OM3 +2 OS1 +4 = +8 points → Likely oncogenic", …},
 "note": "Evidence, not a classification. …"}

Nothing is stored. The answer is evidence, not a clinical classification. If the reference residue is not the residue in the sequence, ref_mismatch is true and acmg is null. A single variant takes 2 to 3 s. Unknown protein or no position is HTTP 400 with ok: false.

Try it
POST /analysis/api/upload/interpret/

Protein reports

What the Summary tabs and the PPI network draw, as data. Not versioned: they follow the pages.

GET /summary/api/overview/{accession}/

Overview

The Summary Overview: the chain split into disordered and ordered, variants per source against the protein's own rate, annotated spans.

Parameters
NameInDescription
accessionpath · requiredGENCODE protein accession.
Example request https://discanvis.elte.hu/summary/api/overview/RAF1-201/
curl -s 'https://discanvis.elte.hu/summary/api/overview/RAF1-201/'
Example response · abridged, RAF1-201
{"ok": true,
 "protein": {"accession": "RAF1-201", "gene": "RAF1", "uniprot": "P04049", "length": 648, …},
 "chain": {"disordered": 238, "ordered": 410, "called": 648, "disordered_share": 0.3673},
 "mutations": {"disordered": 371, "ordered": 390, "total": 761,
               "sources": [{"key": "TCGA", "total": 68, "disordered": 40, "ordered": 28, …}, …]},
 "verdict": {"side": "disordered", "ratio": 1.64, "even_band": [0.87, 1.15], …},
 "bands": {…}, "annotation_kinds": […], "localisation": {…}, "anatomy": {…}}

Unknown accession: HTTP 404 {"ok": false, "error": "No such protein."}.

Try it
/summary/api/overview/{accession}/
GET /summary/api/statistics/{accession}/

Statistics

The Statistics tab's aggregates: counts per source and per ClinVar significance, the scored missense matrix and the proteome baselines.

Parameters
NameInDescription
accessionpath · requiredGENCODE protein accession.
Example request https://discanvis.elte.hu/summary/api/statistics/RAF1-201/
curl -s 'https://discanvis.elte.hu/summary/api/statistics/RAF1-201/'
Example response · abridged, RAF1-201
{"ok": true, "protein": {"accession": "RAF1-201", …},
 "chain": {"disordered": 238, "ordered": 410, …}, "verdict": {"side": "disordered", "ratio": 1.64, …},
 "disorder": {"runs": [{"start": 1, "end": 56, "kind": "disordered"}, …], "threshold": 2.0, …},
 "classes": […], "roi": […], "sources": [{"key": "TCGA", "origin": "somatic", "unit": "samples",
                                          "totals": {"missense": 68, "frameshift": 9, …}}, …],
 "somatic": {…}, "hotspot": {…}, "clinvar": {…}, "predictors": {…}, "gnomad": {…},
 "cancer_types": […], "proteome": {…}}

Aggregates only, no record lists; gzip. About 140 KB for RAF1-201.

Try it
/summary/api/statistics/{accession}/
GET /summary/api/statistics/{accession}/mave/

MAVE sets

The MAVE sets of the protein, and how each predictor separates germline pathogenic from benign variants there.

Parameters
NameInDescription
accessionpath · requiredGENCODE protein accession.
Example request https://discanvis.elte.hu/summary/api/statistics/RAF1-201/mave/
curl -s 'https://discanvis.elte.hu/summary/api/statistics/RAF1-201/mave/'
Example response · abridged, RAF1-201
{"ok": true,
 "sets": [{"urn": "urn:mavedb:00001002-a-1", "source": "mavedb", "title": "RAF1 Raf-like Ras-binding domain",
           "gene": "RAF1", "lower_is_damaging": true, "start": 58, "end": 128, "n": 1420}, …],
 "names": ["SIFT4G", "MutationAssessor", …], "kinds": ["rankscore", "rankscore", …]}

Computed on request, under 1 s.

Try it
/summary/api/statistics/{accession}/mave/
GET /browse/ppi/api/

PPI network

The interaction neighbourhood of one protein: partners with their disease and cancer roll-ups, the structural shortlist and the graph.

Parameters
NameInDescription
accessionquery · requiredGENCODE protein accession of the hub.
Example request https://discanvis.elte.hu/browse/ppi/api/?accession=RAF1-201
curl -s 'https://discanvis.elte.hu/browse/ppi/api/?accession=RAF1-201'
Example response · abridged, RAF1-201
{"hub_accession": "RAF1-201",
 "hub": {"accession": "RAF1-201", "gene_name": "RAF1", "entry_uniprot": "P04049", "sequence_length": 648, …},
 "hub_disease_rollup": {…}, "hub_cancer_rollup": {…},
 "partners": [{"accession": "QARS1-201", "gene_name": "QARS1", "ppi_databases": ["intact"], …}, …],
 "structural_shortlist": […], "graph": {…}, "meta": {…}}

Large and slow (RAF1-201: 3.6 MB, about 4 s). Without accession: HTTP 400 missing_accession; unknown accession: 404. The structural shortlist reports co-occurrence in a PDB entry, not a computed interface.

Try it
/browse/ppi/api/
GET /summary/embed/explore/{accession}/

Explore figure (for an iframe)

The Explore figure with its View and Settings bar as an HTML page, to embed.

Parameters
NameInDescription
accessionpath · requiredGENCODE protein accession.
positionqueryMark one residue.
startqueryWith end: select and zoom to a region.
endqueryWith start.
variantqueryA change such as S257L: marks the residue and adds the lost / gained motif rows.
viewquerysummary, structure, pathogenicity, orthologs or custom.
levelquerysimplified or detailed.
tracksqueryComma-separated rows to show.
Example request https://discanvis.elte.hu/summary/embed/explore/RAF1-201/?position=257
curl -s 'https://discanvis.elte.hu/summary/embed/explore/RAF1-201/?position=257'
Example response · abridged, RAF1-201
<!DOCTYPE html> … the Explore figure with its View / Settings bar, for an iframe … (HTML, not JSON)

Also compare=1 with predictors=a,b (Variant effect with the predictor lanes compared). /summary/embed/overview/{accession}/, …/structure/… and …/table/… are the Overview, the structure view and the feature table in the same way. Unknown accession: 404 Protein not found.

Try it
/summary/embed/explore/{accession}/

Sets of proteins

Cohorts, region sets and motif scans: the Analysis page without the page.

GET /api/v1/analysis/catalog/

Catalog

Everything selectable (cohorts, region sets, sources, units, columns, predictors, scan layers) and the parameter each belongs to.

Parameters
NameInDescription
term_queryqueryNarrow the DisProt term list (the first 100 are returned).
Example request https://discanvis.elte.hu/api/v1/analysis/catalog/
curl -s 'https://discanvis.elte.hu/api/v1/analysis/catalog/'
Example response · abridged, RAF1-201
{"version": "1",
 "endpoints": {"catalog": "/api/v1/analysis/catalog/", "summary": "…", "table": "…", "scan": "…"},
 "parameters": {"cohorts": "comma-separated cohort keys (see `cohorts`)", "unit": "protein | region | …", …},
 "cohorts": [{"group": "Disease", "items": [{"key": "cancer_drivers", "label": "Cancer Gene Census", …}]}, …],
 "region_sets": […], "sources": […], "units": […], "metrics": {…},
 "predictors": [{"key": "rank_sift4g", "label": "SIFT4G", "cutoff": 0.5, …}, …],
 "scan": {"modes": ["annotation", "regex", "pssm"], "layers": ["Elm", "PEM", …], "ptm_types": […]}}

Start here for the next three: a client that has never seen DisCanVis can build every call from this one answer.

Try it
/api/v1/analysis/catalog/
GET /api/v1/analysis/summary/

Summary of a set

Aggregate statistics for a selection: the Analysis overview, as data.

Parameters
NameInDescription
cohortsquery · requiredComma-separated cohort keys from the catalog.
modequeryHow several cohorts combine.
heavyquery1 adds the per-gene and per-region rankings.
Example request https://discanvis.elte.hu/api/v1/analysis/summary/?cohorts=cancer_drivers&mode=intersect
curl -s 'https://discanvis.elte.hu/api/v1/analysis/summary/?cohorts=cancer_drivers&mode=intersect'
Example response · abridged, RAF1-201
{"cohorts": [{"key": "cancer_drivers", "label": "Cancer Gene Census", …}],
 "residues": {"disordered": 350117, "ordered": 435585, "total": 785702},
 "variant_classes": [{"key": "TCGA", "missense": 109651, "frameshift": 18627, "indel": 520}, …],
 "driver_proteins": 857, "conditions": {…}, "driver_composition": […], …}

The same filters as the table (region_sets, sources, chromosome, go, disease, patho_*, …; the catalog lists them). An unknown cohort key is not an error (HTTP 200): read cohorts in the answer for what was used.

Try it
/api/v1/analysis/summary/
GET /api/v1/analysis/table/

Rows of a set

The rows for a selection, as JSON, CSV or TSV.

Parameters
NameInDescription
cohortsquery · requiredComma-separated cohort keys from the catalog.
unitqueryprotein, region, merged, study or mave.
columnsqueryComma-separated column keys to keep; the answer lists available_columns.
formatqueryjson, csv or tsv.
limitqueryPage size, at most 200.
offsetqueryFirst row.
sortqueryA column key.
dirqueryasc or desc.
Example request https://discanvis.elte.hu/api/v1/analysis/table/?cohorts=cancer_drivers&unit=protein&columns=gene,protein,missense,disordered_pct&format=json&limit=3
curl -s 'https://discanvis.elte.hu/api/v1/analysis/table/?cohorts=cancer_drivers&unit=protein&columns=gene,protein,missense,disordered_pct&format=json&limit=3'
Example response · abridged, RAF1-201
{"total": 857, "offset": 0, "unit": "protein",
 "rows": [{"gene": "A1CF", "protein": "A1CF-201", "missense": 113, "disordered_pct": 35.7},
          {"gene": "ABCB1", "protein": "ABCB1-211", "missense": 291, "disordered_pct": 6.5}, …],
 "set_label": "Cancer Gene Census · all mutation sources",
 "available_columns": ["protein", "gene", "chromosome", "length", "missense", …]}

An unknown columns value is HTTP 400 naming the valid ones (unknown column(s): …); an unknown format is 400 too. Also mode, q, cf_<column> filters and the filters of the summary.

Try it
/api/v1/analysis/table/
POST /api/v1/analysis/scan/

Motif and annotation scan

Motif or annotation discovery over a list of proteins: one row per hit, under rois.

Parameters
NameInDescription
roibody · requiredNewline-separated identifiers, each optionally identifier start end.
search_typebodygene_name (default), uniprot or gencode.
search_modebodyfull (whole sequence) or region.
discovery_methodbodyannotation (with find_region, see the catalog's scan.layers) or prediction (with motif_mode regex + regex_input, or pssm + pssm_json / pssm_tsv).
columnsbodyWhich data columns to compute (the row keeps every key; the others are null). requested_columns is not read.
Example request
curl -s -X POST 'https://discanvis.elte.hu/api/v1/analysis/scan/' \
  -H 'Content-Type: application/json' \
  -d '{
  "roi": "RAF1",
  "search_type": "gene_name",
  "search_mode": "full",
  "discovery_method": "prediction",
  "motif_mode": "regex",
  "regex_input": "[ST].{0,2}P",
  "columns": [
    "identifier",
    "gene",
    "start",
    "end"
  ]
}'
Example response · abridged, RAF1-201
{"success": true,
 "rois": [{"identifier": "RAF1-201", "gene": "RAF1", "region_name": "Motif: SP", "start": 29, "end": 30,
           "disorder_combined": null, "tcgam": null, …}, …],
 "header": […], "errors": [], "plot_payload": {…}, "motif_visualization": {…}, "run_meta": {…}}

Read-only; nothing is stored. GET is HTTP 405. A list of many proteins can take minutes: keep the body small.

Try it
POST /api/v1/analysis/scan/
GET /statistics/api/

Proteome statistics

The JSON behind the Proteome statistics charts for a saved set, a GO term, a PPI neighbourhood or your own list.

Parameters
NameInDescription
setqueryA saved set (human, cancer_drivers, elm, pem, scansite, mfib, dibs, phasepro, disordered_pdb), or go, ppi, protein_list.
go_idqueryWith set=go: a GO id such as GO:0006915.
accessionqueryWith set=ppi: the hub (accession, UniProt, gene).
ppi_sourcesqueryWith set=ppi: intact,hippie,biogrid (default).
protein_listqueryWith set=protein_list: up to 5 000 identifiers (gene, accession, UniProt, entry name, transcript), comma- or line-separated.
Example request https://discanvis.elte.hu/statistics/api/?set=human
curl -s 'https://discanvis.elte.hu/statistics/api/?set=human'
Example response · abridged, RAF1-201
{"set": "human", "set_label": "Human proteome", "protein_count": 19837,
 "annotations": {…}, "protein_set_table": {…}, "disorder_residues": {…},
 "mutation_by_category": {…}, "clinvar_disorder": {…}, "pathogenicity": {…},
 "structure_context": {…}, …}

A saved set is a snapshot file (human: 2.7 MB). The others are computed and refuse a set that is too large (HTTP 400); a missing snapshot is 503. Unknown set: 400.

Try it
/statistics/api/
GET /ajax/go-genes/

Proteins of a GO term

The main-isoform proteins annotated with a GO term, as symbols and accessions, ready for a scan or a list.

Parameters
NameInDescription
idquery · requiredA GO id such as GO:0005813.
Example request https://discanvis.elte.hu/ajax/go-genes/?id=GO:0005813
curl -s 'https://discanvis.elte.hu/ajax/go-genes/?id=GO:0005813'
Example response · abridged, RAF1-201
{"go_id": "GO:0005813", "genes": ["AAAS", "ABRAXAS2", …],
 "accessions": ["AAAS-201", "ABRAXAS2-201", …], "count": 661, "protein_main_isoforms": 661, …}

About 1 s for a large term. No id: HTTP 400. An id with no proteins is 200 with an empty accessions and a hint.

Try it
/ajax/go-genes/
GET /ajax/ppi-proteins/

A protein and its partners

The main-isoform accessions of a hub and its direct interaction partners.

Parameters
NameInDescription
hubquery · requiredGene symbol, accession or UniProt of the hub.
ppi_sourcesqueryComma-separated: intact, hippie, biogrid.
Example request https://discanvis.elte.hu/ajax/ppi-proteins/?hub=RAF1
curl -s 'https://discanvis.elte.hu/ajax/ppi-proteins/?hub=RAF1'
Example response · abridged, RAF1-201
{"hub": "RAF1", "hub_accession": "RAF1-201", "hub_gene": "RAF1",
 "ppi_sources": ["intact", "hippie"], "genes": ["AARSD1", "ABCB5", …],
 "accessions": ["AARSD1-202", "ABCB5-202", …], "count": 482, …}

No hub: HTTP 400; a hub that is not a main isoform: 404 with a hint.

Try it
/ajax/ppi-proteins/
POST /api/v1/batch/analyze/ legacy

Batch analysis (legacy path)

The engine of the retired Batch Analysis page. /api/v1/analysis/scan/ is the same engine under the current name.

Parameters
NameInDescription
roibody · requiredNewline-separated identifiers, each optionally identifier start end.
search_typebodygene_name (default), uniprot or gencode.
search_modebodyfull or region.
discovery_methodbodyannotation (with find_region) or prediction (with motif_mode).
columnsbodyWhich data columns to compute.
Example request
curl -s -X POST 'https://discanvis.elte.hu/api/v1/batch/analyze/' \
  -H 'Content-Type: application/json' \
  -d '{
  "roi": "RAF1",
  "search_type": "gene_name",
  "search_mode": "region",
  "discovery_method": "annotation",
  "find_region": "Elm",
  "columns": [
    "identifier",
    "gene",
    "region_name",
    "start",
    "end"
  ]
}'
Example response · abridged, RAF1-201
{"success": true,
 "rois": [{"identifier": "RAF1-201", "gene": "RAF1", "region_name": "ELM: LIG_14-3-3_CanoR_1",
           "start": 618, "end": 623, "tcgam": null, …}, …], …}

Kept for scripts that already call it; new code should use /api/v1/analysis/scan/. GET answers a short description of the endpoint. Empty roi: HTTP 400 {"success": false, "errors": […]}.

Try it
POST /api/v1/batch/analyze/

Layer names

The names /rest/{id}/{layer} and /download/{id}/{layer} take, read from the code. A region or a residue answers the layers marked yes; the others exist only for a whole protein. A layer with no rows is empty or null.

LayerWhat it holdsRegion and residue
proteinIdentifiers: accession, UniProt, transcript, gene, name, chromosome, driver label.no
exonExon borders on the sequence.yes
phastconsphastCons conservation per residue.yes
complexity-segLow-complexity regions (SEG).yes
complexity-dustLow-complexity regions (DUST).yes
complexity-trfTandem repeats (TRF).yes
polymorphismCommon polymorphisms (no rows are loaded at present).yes
omimOMIM disease variants via UniProt humsavar (no rows are loaded at present).yes
clinvarGermline ClinVar records: change, disease, significance, RCV accession.yes
pathogenicityPredictor scores per substitution (dbNSFP-style columns, AlphaMissense).no
pdbPDB structure spans, ordered and disordered stretches. Coordinates are 0-based here.yes
pfamPfam domains with alignment and envelope spans.yes
combinedCombined disorder score per residue (disordered at 2.0 or more).yes
anchorANCHOR2 binding propensity.yes
iupredIUPred3 disorder score.yes
aiupred-bindingAIUPred-Binding score.no
mobidbMobiDB experimental disorder.yes
alphafoldAlphaFold pLDDT confidence.yes
tcgamSomatic missense variants from TCGA, with cancer types.yes
tcgafSomatic frameshift variants from TCGA.yes
tcgaiSomatic in-frame indels from TCGA.yes
cosmicmCOSMIC missense (COSMIC is not loaded: no rows).yes
cosmicfCOSMIC frameshift (not loaded: no rows).yes
cosmiciCOSMIC indel (not loaded: no rows).yes
cbioportalmSomatic missense variants from cBioPortal.no
cbioportalfSomatic frameshift variants from cBioPortal.no
cbioportaliSomatic in-frame indels from cBioPortal.no
roisigSignificantly mutated regions (iSiMPRe).yes
elmELM motif instances.yes
pemPEM predicted motifs.no
momapMoMAP motifs.no
scansiteScanSite kinase and binding motifs.yes
elmswitchesELM switches (a binding site and the modification that gates it).yes
ptmPost-translational modification sites.yes
roiUniProt regions of interest.yes
bindingUniProt binding sites.yes
dibsDIBS disordered binding regions.yes
mfibMFIB fuzzy complexes.yes
binding_domainBinding domains.yes
phaseproPhaSePro phase-separation regions.yes
conservationConservation scores per taxonomic level.yes
ppiInteraction partners (HIPPIE, IntAct, BioGRID).no

In a region or residue answer the disorder layers (combined, anchor, iupred, mobidb, alphafold) share one key, Disordered. pathogenicity holds the predictor scores per substitution, AlphaMissense among them; it is not in a region or residue answer.

From Python

Set BASE to this site or another deployment.

The variants in a region
import requests

BASE = "https://discanvis.elte.hu"

r = requests.get(
    f"{BASE}/rest/RAF1-201/250-265.json",
    params={"annotations": '["clinvar", "tcgam"]'},
    timeout=60,
)
data = r.json()
if "error" in data:            # /rest/ answers errors with HTTP 200
    raise SystemExit(data["error"])
print(data["meta"]["release"]["data_release"], data["tcgam"]["mutations"])
A set of proteins as a table
import io
import pandas as pd
import requests

BASE = "https://discanvis.elte.hu"

r = requests.get(
    f"{BASE}/api/v1/analysis/table/",
    params={"cohorts": "cancer_drivers", "unit": "protein", "format": "csv",
            "columns": "gene,protein,missense,disordered_pct", "limit": 200},
    timeout=120,
)
r.raise_for_status()               # these endpoints use 4xx with an "error" key
df = pd.read_csv(io.StringIO(r.text))