← Back to variant description
GeneBe API Showcase
This page demonstrates how to use the GeneBe API to query variant information. The API provides programmatic access to genomic annotations and variant data.
API presented here should be used for checking single variants. If you want to check many variants at once, please use other API endpoints that you will find in the documentation.
Documentation & Advanced Usage
• Complete API documentation:docs.genebe.net/docs/api/overview/
• Interactive endpoint tester:api.genebe.net/cloud/gb-api-doc/swagger-ui/
• Python client for pandas:pypi.org/project/genebe/
• Java CLI for VCF files:github.com/pstawinski/genebe-cli
• All tools documented at:docs.genebe.net
API Request Examples for Variant: 17-31229454-T-TC (hg38)
Bash / cURL Example
bash
curl "https://api.genebe.net/cloud/api-public/v1/variant?chr=17&pos=31229454&ref=T&alt=TC&genome=hg38&allGenes=true"
API Response
json
{
"variants": [
{
"chr": "17",
"pos": 31229454,
"ref": "T",
"alt": "TC",
"effect": "frameshift_variant",
"transcript": "ENST00000358273.9",
"consequences": [
{
"aa_ref": "Q",
"aa_alt": "P?",
"canonical": false,
"protein_coding": true,
"strand": true,
"consequences": [
"frameshift_variant"
],
"exon_rank": 21,
"exon_rank_end": null,
"exon_count": 58,
"intron_rank": null,
"intron_rank_end": null,
"gene_symbol": "NF1",
"gene_hgnc_id": 7765,
"hgvs_c": "c.2842dupC",
"hgvs_p": "p.Gln948fs",
"transcript": "NM_001042492.3",
"protein_id": "NP_001035957.1",
"transcript_support_level": null,
"aa_start": 948,
"aa_end": null,
"aa_length": 2839,
"cds_start": 2843,
"cds_end": null,
"cds_length": 8520,
"cdna_start": 3176,
"cdna_end": null,
"cdna_length": 12373,
"mane_select": "ENST00000358273.9",
"mane_plus": null,
"biotype": null,
"feature": null
},
{
"aa_ref": "Q",
"aa_alt": "P?",
"canonical": true,
"protein_coding": true,
"strand": true,
"consequences": [
"frameshift_variant"
],
"exon_rank": 21,
"exon_rank_end": null,
"exon_count": 58,
"intron_rank": null,
"intron_rank_end": null,
"gene_symbol": "NF1",
"gene_hgnc_id": 7765,
"hgvs_c": "c.2842dupC",
"hgvs_p": "p.Gln948fs",
"transcript": "ENST00000358273.9",
"protein_id": "ENSP00000351015.4",
"transcript_support_level": 1,
"aa_start": 948,
"aa_end": null,
"aa_length": 2839,
"cds_start": 2843,
"cds_end": null,
"cds_length": 8520,
"cdna_start": 3176,
"cdna_end": null,
"cdna_length": 12373,
"mane_select": "NM_001042492.3",
"mane_plus": null,
"biotype": null,
"feature": null
},
{
"aa_ref": "Q",
"aa_alt": "P?",
"canonical": false,
"protein_coding": true,
"strand": true,
"consequences": [
"frameshift_variant"
],
"exon_rank": 21,
"exon_rank_end": null,
"exon_count": 57,
"intron_rank": null,
"intron_rank_end": null,
"gene_symbol": "NF1",
"gene_hgnc_id": 7765,
"hgvs_c": "c.2842dupC",
"hgvs_p": "p.Gln948fs",
"transcript": "ENST00000356175.7",
"protein_id": "ENSP00000348498.3",
"transcript_support_level": 1,
"aa_start": 948,
"aa_end": null,
"aa_length": 2818,
"cds_start": 2843,
"cds_end": null,
"cds_length": 8457,
"cdna_start": 3226,
"cdna_end": null,
"cdna_length": 12362,
"mane_select": null,
"mane_plus": null,
"biotype": null,
"feature": null
},
{
"aa_ref": null,
"aa_alt": null,
"canonical": false,
"protein_coding": false,
"strand": true,
"consequences": [
"non_coding_transcript_exon_variant"
],
"exon_rank": 21,
"exon_rank_end": null,
"exon_count": 58,
"intron_rank": null,
"intron_rank_end": null,
"gene_symbol": "NF1",
"gene_hgnc_id": 7765,
"hgvs_c": "n.2842dupC",
"hgvs_p": null,
"transcript": "ENST00000579081.6",
"protein_id": "ENSP00000462408.2",
"transcript_support_level": 1,
"aa_start": null,
"aa_end": null,
"aa_length": null,
"cds_start": -4,
"cds_end": null,
"cds_length": null,
"cdna_start": null,
"cdna_end": null,
"cdna_length": 8788,
"mane_select": null,
"mane_plus": null,
"biotype": null,
"feature": null
},
{
"aa_ref": "Q",
"aa_alt": "P?",
"canonical": false,
"protein_coding": true,
"strand": true,
"consequences": [
"frameshift_variant"
],
"exon_rank": 22,
"exon_rank_end": null,
"exon_count": 59,
"intron_rank": null,
"intron_rank_end": null,
"gene_symbol": "NF1",
"gene_hgnc_id": 7765,
"hgvs_c": "c.2872dupC",
"hgvs_p": "p.Gln958fs",
"transcript": "ENST00000691014.1",
"protein_id": "ENSP00000510595.1",
"transcript_support_level": null,
"aa_start": 958,
"aa_end": null,
"aa_length": 2849,
"cds_start": 2873,
"cds_end": null,
"cds_length": 8550,
"cdna_start": 3206,
"cdna_end": null,
"cdna_length": 12415,
"mane_select": null,
"mane_plus": null,
"biotype": null,
"feature": null
},
{
"aa_ref": "Q",
"aa_alt": "P?",
"canonical": false,
"protein_coding": true,
"strand": true,
"consequences": [
"frameshift_variant"
],
"exon_rank": 21,
"exon_rank_end": null,
"exon_count": 57,
"intron_rank": null,
"intron_rank_end": null,
"gene_symbol": "NF1",
"gene_hgnc_id": 7765,
"hgvs_c": "c.2842dupC",
"hgvs_p": "p.Gln948fs",
"transcript": "NM_000267.4",
"protein_id": "NP_000258.1",
"transcript_support_level": null,
"aa_start": 948,
"aa_end": null,
"aa_length": 2818,
"cds_start": 2843,
"cds_end": null,
"cds_length": 8457,
"cdna_start": 3176,
"cdna_end": null,
"cdna_length": 12310,
"mane_select": null,
"mane_plus": null,
"biotype": null,
"feature": null
},
{
"aa_ref": "Q",
"aa_alt": "P?",
"canonical": false,
"protein_coding": true,
"strand": true,
"consequences": [
"frameshift_variant"
],
"exon_rank": 22,
"exon_rank_end": null,
"exon_count": 59,
"intron_rank": null,
"intron_rank_end": null,
"gene_symbol": "NF1",
"gene_hgnc_id": 7765,
"hgvs_c": "c.2887dupC",
"hgvs_p": "p.Gln963fs",
"transcript": "ENST00000696138.1",
"protein_id": "ENSP00000512431.1",
"transcript_support_level": null,
"aa_start": 963,
"aa_end": null,
"aa_length": 2807,
"cds_start": 2888,
"cds_end": null,
"cds_length": 8424,
"cdna_start": 3271,
"cdna_end": null,
"cdna_length": 12484,
"mane_select": null,
"mane_plus": null,
"biotype": null,
"feature": null
},
{
"aa_ref": "Q",
"aa_alt": "P?",
"canonical": false,
"protein_coding": true,
"strand": true,
"consequences": [
"frameshift_variant"
],
"exon_rank": 13,
"exon_rank_end": null,
"exon_count": 50,
"intron_rank": null,
"intron_rank_end": null,
"gene_symbol": "NF1",
"gene_hgnc_id": 7765,
"hgvs_c": "c.1840dupC",
"hgvs_p": "p.Gln614fs",
"transcript": "ENST00000456735.6",
"protein_id": "ENSP00000389907.2",
"transcript_support_level": 5,
"aa_start": 614,
"aa_end": null,
"aa_length": 2502,
"cds_start": 1841,
"cds_end": null,
"cds_length": 7509,
"cdna_start": 1841,
"cdna_end": null,
"cdna_length": 7787,
"mane_select": null,
"mane_plus": null,
"biotype": null,
"feature": null
},
{
"aa_ref": null,
"aa_alt": null,
"canonical": false,
"protein_coding": false,
"strand": true,
"consequences": [
"non_coding_transcript_exon_variant"
],
"exon_rank": 5,
"exon_rank_end": null,
"exon_count": 21,
"intron_rank": null,
"intron_rank_end": null,
"gene_symbol": "NF1",
"gene_hgnc_id": 7765,
"hgvs_c": "n.1009dupC",
"hgvs_p": null,
"transcript": "ENST00000493220.5",
"protein_id": null,
"transcript_support_level": 2,
"aa_start": null,
"aa_end": null,
"aa_length": null,
"cds_start": -4,
"cds_end": null,
"cds_length": null,
"cdna_start": null,
"cdna_end": null,
"cdna_length": 5691,
"mane_select": null,
"mane_plus": null,
"biotype": null,
"feature": null
},
{
"aa_ref": null,
"aa_alt": null,
"canonical": false,
"protein_coding": false,
"strand": true,
"consequences": [
"non_coding_transcript_exon_variant"
],
"exon_rank": 19,
"exon_rank_end": null,
"exon_count": 29,
"intron_rank": null,
"intron_rank_end": null,
"gene_symbol": "NF1",
"gene_hgnc_id": 7765,
"hgvs_c": "n.*2243dupC",
"hgvs_p": null,
"transcript": "ENST00000495910.6",
"protein_id": "ENSP00000463682.1",
"transcript_support_level": 2,
"aa_start": null,
"aa_end": null,
"aa_length": null,
"cds_start": -4,
"cds_end": null,
"cds_length": null,
"cdna_start": null,
"cdna_end": null,
"cdna_length": 8223,
"mane_select": null,
"mane_plus": null,
"biotype": null,
"feature": null
},
{
"aa_ref": null,
"aa_alt": null,
"canonical": false,
"protein_coding": false,
"strand": true,
"consequences": [
"non_coding_transcript_exon_variant"
],
"exon_rank": 1,
"exon_rank_end": null,
"exon_count": 12,
"intron_rank": null,
"intron_rank_end": null,
"gene_symbol": "NF1",
"gene_hgnc_id": 7765,
"hgvs_c": "n.187dupC",
"hgvs_p": null,
"transcript": "ENST00000696139.1",
"protein_id": "ENSP00000512432.1",
"transcript_support_level": null,
"aa_start": null,
"aa_end": null,
"aa_length": null,
"cds_start": -4,
"cds_end": null,
"cds_length": null,
"cdna_start": null,
"cdna_end": null,
"cdna_length": 1639,
"mane_select": null,
"mane_plus": null,
"biotype": null,
"feature": null
},
{
"aa_ref": null,
"aa_alt": null,
"canonical": false,
"protein_coding": false,
"strand": true,
"consequences": [
"3_prime_UTR_variant"
],
"exon_rank": 19,
"exon_rank_end": null,
"exon_count": 29,
"intron_rank": null,
"intron_rank_end": null,
"gene_symbol": "NF1",
"gene_hgnc_id": 7765,
"hgvs_c": "n.*2243dupC",
"hgvs_p": null,
"transcript": "ENST00000495910.6",
"protein_id": "ENSP00000463682.1",
"transcript_support_level": 2,
"aa_start": null,
"aa_end": null,
"aa_length": null,
"cds_start": -4,
"cds_end": null,
"cds_length": null,
"cdna_start": null,
"cdna_end": null,
"cdna_length": 8223,
"mane_select": null,
"mane_plus": null,
"biotype": null,
"feature": null
}
],
"gene_symbol": "NF1",
"gene_hgnc_id": 7765,
"dbsnp": "rs1555614354",
"frequency_reference_population": null,
"hom_count_reference_population": 0,
"allele_count_reference_population": 0,
"gnomad_exomes_af": null,
"gnomad_genomes_af": null,
"gnomad_exomes_ac": null,
"gnomad_genomes_ac": null,
"gnomad_exomes_homalt": null,
"gnomad_genomes_homalt": null,
"gnomad_mito_homoplasmic": null,
"gnomad_mito_heteroplasmic": null,
"computational_score_selected": null,
"computational_prediction_selected": null,
"computational_source_selected": null,
"splice_score_selected": 0,
"splice_prediction_selected": "Benign",
"splice_source_selected": "max_spliceai",
"revel_score": null,
"revel_prediction": null,
"alphamissense_score": null,
"alphamissense_prediction": null,
"bayesdelnoaf_score": null,
"bayesdelnoaf_prediction": null,
"phylop100way_score": 7.539,
"phylop100way_prediction": "Pathogenic",
"spliceai_max_score": 0,
"spliceai_max_prediction": "Benign",
"dbscsnv_ada_score": null,
"dbscsnv_ada_prediction": null,
"apogee2_score": null,
"apogee2_prediction": null,
"mitotip_score": null,
"mitotip_prediction": null,
"acmg_score": 12,
"acmg_classification": "Pathogenic",
"acmg_criteria": "PVS1,PM2,PP5_Moderate",
"acmg_by_gene": [
{
"score": 12,
"benign_score": 0,
"pathogenic_score": 12,
"criteria": [
"PVS1",
"PM2",
"PP5_Moderate"
],
"verdict": "Pathogenic",
"transcript": "ENST00000358273.9",
"gene_symbol": "NF1",
"hgnc_id": 7765,
"effects": [
"frameshift_variant"
],
"inheritance_mode": "AD",
"hgvs_c": "c.2842dupC",
"hgvs_p": "p.Gln948fs"
}
],
"clinvar_disease": " type 1,Neurofibromatosis",
"clinvar_classification": "Likely pathogenic",
"clinvar_review_status": "criteria provided, single submitter",
"clinvar_submissions_summary": "LP:1",
"phenotype_combined": "Neurofibromatosis, type 1",
"pathogenicity_classification_combined": "Likely pathogenic",
"custom_annotations": null
}
],
"message": null
}