{"openapi":"3.1.0","info":{"title":"Ensembl API","version":"1.0.0","description":"The Ensembl genome database as an API, powered by the official Ensembl REST service from EMBL-EBI. Look up any gene by symbol or Ensembl stable id for its biotype, genomic location, strand, description and transcripts; resolve any feature (gene, transcript, exon) by stable id; pull external database cross-references; fetch sequence variants by rsID with their alleles, most-severe consequence, minor-allele frequency, clinical significance and genomic mappings; list the genes, transcripts, exons, variations or repeats overlapping any genomic region; retrieve genomic, cDNA, CDS or protein sequences by id; and read genome-assembly metadata including the karyotype and chromosome lengths. Across human, mouse and 300+ vertebrate species. Ideal for bioinformatics pipelines, genome browsers and variant-annotation tools, genetics research apps, clinical-genomics dashboards and life-science chatbots.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ensembl-api","description":"oanor gateway"}],"tags":[{"name":"Genes"},{"name":"Variants"},{"name":"Sequences"},{"name":"Genome"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/gene":{"get":{"operationId":"get_v1_gene","tags":["Genes"],"summary":"Look up a gene by symbol","description":"","parameters":[{"name":"species","in":"query","required":false,"description":"Species (default human)","schema":{"type":"string"},"example":"human"},{"name":"symbol","in":"query","required":true,"description":"Gene symbol, e.g. BRCA2","schema":{"type":"string"},"example":"BRCA2"},{"name":"expand","in":"query","required":false,"description":"1 = include transcripts","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"gene":{"id":"ENSG00000139618","end":32400268,"start":32315086,"source":"ensembl_havana","strand":1,"symbol":"BRCA2","biotype":"protein_coding","species":"human","version":19,"assembly":"GRCh38","chromosome":"13","description":"BRCA2 DNA repair associated [Source:HGNC Symbol;Acc:HGNC:1101]","canonical_transcript":"ENST00000380152.8"}},"meta":{"timestamp":"2026-06-01T08:14:11.651Z","request_id":"eeae2903-13a7-4203-b35f-a6d709ce42c8"},"status":"ok","message":"Gene retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/lookup":{"get":{"operationId":"get_v1_lookup","tags":["Genes"],"summary":"Any feature by Ensembl stable id","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Ensembl stable id, e.g. ENSG00000139618","schema":{"type":"string"},"example":"ENSG00000139618"},{"name":"expand","in":"query","required":false,"description":"1 = include transcripts","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"feature":{"id":"ENSG00000139618","end":32400268,"type":"Gene","start":32315086,"strand":1,"symbol":"BRCA2","biotype":"protein_coding","species":"homo_sapiens","version":19,"assembly":"GRCh38","chromosome":"13","description":"BRCA2 DNA repair associated [Source:HGNC Symbol;Acc:HGNC:1101]"}},"meta":{"timestamp":"2026-06-01T08:14:16.547Z","request_id":"4f0cbe18-c928-44ba-9afd-24b88686ed57"},"status":"ok","message":"Feature retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/xrefs":{"get":{"operationId":"get_v1_xrefs","tags":["Genes"],"summary":"External cross-references","description":"","parameters":[{"name":"species","in":"query","required":false,"description":"Species (default human)","schema":{"type":"string"},"example":"human"},{"name":"symbol","in":"query","required":true,"description":"Gene symbol","schema":{"type":"string"},"example":"BRCA2"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":2,"xrefs":[{"id":"ENSG00000139618","type":"gene"},{"id":"LRG_293","type":"gene"}],"symbol":"BRCA2","species":"human"},"meta":{"timestamp":"2026-06-01T08:14:16.721Z","request_id":"88eb9c44-b25b-4586-93f5-395fbbf415b0"},"status":"ok","message":"Cross-references retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/region":{"get":{"operationId":"get_v1_region","tags":["Variants"],"summary":"Features overlapping a region","description":"","parameters":[{"name":"species","in":"query","required":false,"description":"Species (default human)","schema":{"type":"string"},"example":"human"},{"name":"region","in":"query","required":true,"description":"chr:start-end (max 1 Mb)","schema":{"type":"string"},"example":"17:43044295-43125483"},{"name":"feature","in":"query","required":false,"description":"gene|transcript|exon|variation|repeat|cds","schema":{"type":"string"},"example":"gene"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"region":"17:43044295-43125483","feature":"gene","species":"human","features":[{"id":"ENSG00000240828","end":43079780,"name":"RPL21P4","start":43079302,"source":"havana","strand":1,"biotype":"processed_pseudogene"},{"id":"ENSG00000198496","end":43153671,"name":"NBR2","start":43125420,"source":"havana","strand":1,"biotype":"lncRNA"},{"id":"ENSG00000012048","end":43170245,"name":"BRCA1","start":43044292,"source":"ensembl_havana","strand":-1,"biotype":"protein_coding"}]},"meta":{"timestamp":"2026-06-01T08:14:16.860Z","request_id":"08fe80db-8e8e-4b5c-a149-28b01422faa9"},"status":"ok","message":"Region features retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/variant":{"get":{"operationId":"get_v1_variant","tags":["Variants"],"summary":"A sequence variant (rsID)","description":"","parameters":[{"name":"species","in":"query","required":false,"description":"Species (default human)","schema":{"type":"string"},"example":"human"},{"name":"id","in":"query","required":true,"description":"Variant id, e.g. rs699","schema":{"type":"string"},"example":"rs699"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"variant":{"name":"rs699","source":"Variants (including SNPs and indels) imported from dbSNP","evidence":["Frequency","1000Genomes","Cited","ESP","Phenotype_or_Disease","ExAC","TOPMed","gnomAD"],"mappings":[{"end":230710048,"start":230710048,"strand":1,"assembly":"GRCh38","location":"1:230710048-230710048","allele_string":"A/G","seq_region_name":"1"}],"synonyms":["106150.0001","RCV000405686","RCV000019691","RCV000019693","RCV000242838","VCV000018068","RCV000835695","RCV002259306","RCV000019692","rs3182295","rs17856353","rs386606420","rs4714","rs61617185","NM_001384479.1:c.776T>C","NM_001382817.2:c.776T>C","NM_001382817.1:c.803T>C","NM_000029.3:c.803T>C","NP_001371408.1:p.Met259Thr","NM_000029.4:c.803T>C"],"ambiguity":"R","var_class":"SNP","clinical_significance":["benign"],"most_severe_consequence":"missense_variant"}},"meta":{"timestamp":"2026-06-01T08:14:18.547Z","request_id":"256592f1-f1c4-40c4-8573-359d3e2b14ab"},"status":"ok","message":"Variant retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/sequence":{"get":{"operationId":"get_v1_sequence","tags":["Sequences"],"summary":"DNA / cDNA / CDS / protein sequence","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Ensembl stable id","schema":{"type":"string"},"example":"ENSP00000369497"},{"name":"type","in":"query","required":false,"description":"genomic|cds|cdna|protein","schema":{"type":"string"},"example":"protein"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"ENSP00000369497","type":"protein","length":3418,"molecule":"protein","sequence":"MPIGSKERPTFFEIFKTRCNKADLGPISLNWFEELSSEAPPYNSEPAEESEHKNNNYEPNLFKTPQRKPSYNQLASTPIIFKEQGLTLPLYQSPVKELDKFKLDLGRNVPNSRHKSLRTVKTKMDQADDVSCPLLNSCLSESPVVLQCTHVTPQRDKSVVCGSLFHTPKFVKGRQTPKHISESLGAEVDPDMSWSSSLATPPTLSSTVLIVRNEEASETVFPHDTTANVKSYFSNHDESLKKNDRFIASVTDSENTNQREAASHGFGKTSGNSFKVNSCKDHIGKSMPNVLEDEVYETVVDTSEEDSFSLCFSKCRTKNLQKVRTSKTRKKIFHEANADECEKSKNQVKEKYSFVSEVEPNDTDPLDSNVANQKPFESGSDKISKEVVPSLACEWSQLTLSGLNGAQMEKIPLLHISSCDQNISEKDLLDTENKRKKDFLTSENSLPRISSLPKSEKPLNEETVVNKRDEEQHLESHTDCILAVKQAISGTSPVASSFQGIKKSIFRIRESPKETFNASFSGHMTDPNFKKETEASESGLEIHTVCSQKEDSLCPNLIDNGSWPATTTQNSVALKNAGLISTLKKKTNKFIYAIHDETSYKGKKIPKDQKSELINCSAQFEANAFEAPLTFANADSGLLHSSVKRSCSQNDSEEPTLSLTSSFGTILRKCSRNETCSNNTVISQDLDYKEAKCNKEKLQLFITPEADSLSCLQEGQCENDPKSKKVSDIKEEVLAAACHPVQHSKVEYSDTDFQSQKSLLYDHENASTLILTPTSKDVLSNLVMISRGKESYKMSDKLKGNNYESDVELTKNIPMEKNQDVCALNENYKNVELLPPEKYMRVASPSRKVQFNQNTNLRVIQKNQEETTSISKITVNPDSEELFSDNENNFVFQVANERNNLALGNTKELHETDLTCVNEPIFKNSTMVLYGDTGDKQATQVSIKKDLVYVLAEENKNSVKQHIKMTLGQDLKSDISLNIDKIPEKNNDYMNKWAGLLGPISNHSFGGSFRTASNKEIKLSEHNIKKSKMFFKDIEEQYPTSLACVEIVNTLALDNQKKLSKPQSINTVSAHLQSSVVVSDCKNSHITPQMLFSKQDFNSNHNLTPSQKAEITELSTILEESGSQFEFTQFRKPSYILQKSTFEVPENQMTILKTTSEECRDADLHVIMNAPSIGQVDSSKQFEGTVEIKRKFAGLLKNDCNKSASGYLTDENEVGFRGFYSAHGTKLNVSTEALQKAVKLFSDIENISEETSAEVHPISLSSSKCHDSVVSMFKIENHNDKTVSEKNNKCQLILQNNIEMTTGTFVEEITENYKRNTENEDNKYTAASRNSHNLEFDGSDSSKNDTVCIHKDETDLLFTDQHNICLKLSGQFMKEGNTQIKEDLSDLTFLEVAKAQEACHGNTSNKEQLTATKTEQNIKDFETSDTFFQTASGKNISVAKESFNKIVNFFDQKPEELHNFSLNSELHSDIRKNKMDILSYEETDIVKHKILKESVPVGTGNQLVTFQGQPERDEKIKEPTLLGFHTASGKKVKIAKESLDKVKNLFDEKEQGTSEITSFSHQWAKTLKYREACKDLELACETIEITAAPKCKEMQNSLNNDKNLVSIETVVPPKLLSDNLCRQTENLKTSKSIFLKVKVHENVEKETAKSPATCYTNQSPYSVIENSALAFYTSCSRKTSVSQTSLLEAKKWLREGIFDGQPERINTADYVGNYLYENNSNSTIAENDKNHLSEKQDTYLSNSSMSNSYSYHSDEVYNDSGYLSKNKLDSGIEPVLKNVEDQKNTSFSKVISNVKDANAYPQTVNEDICVEELVTSSSPCKNKNAAIKLSISNSNNFEVGPPAFRIASGKIVCVSHETIKKVKDIFTDSFSKVIKENNENKSKICQTKIMAGCYEALDDSEDILHNSLDNDECSTHSHKVFADIQSEEILQHNQNMSGLEKVSKISPCDVSLETSDICKCSIGKLHKSVSSANTCGIFSTASGKSVQVSDASLQNARQVFSEIEDSTKQVFSKVLFKSNEHSDQLTREENTAIRTPEHLISQKGFSYNVVNSSAFSGFSTASGKQVSILESSLHKVKGVLEEFDLIRTEHSLHYSPTSRQNVSKILPRVDKRNPEHCVNSEMEKTCSKEFKLSNNLNVEGGSSENNHSIKVSPYLSQFQQDKQQLVLGTKVSLVENIHVLGKEQASPKNVKMEIGKTETFSDVPVKTNIEVCSTYSKDSENYFETEAVEIAKAFMEDDELTDSKLPSHATHSLFTCPENEEMVLSNSRIGKRRGEPLILVGEPSIKRNLLNEFDRIIENQEKSLKASKSTPDGTIKDRRLFMHHVSLEPITCVPFRTTKERQEIQNPNFTAPGQEFLSKSHLYEHLTLEKSSSNLAVSGHPFYQVSATRNEKMRHLITTGRPTKVFVPPFKTKSHFHRVEQCVRNINLEENRQKQNIDGHGSDDSKNKINDNEIHQFNKNNSNQAVAVTFTKCEEEPLDLITSLQNARDIQDMRIKKKQRQRVFPQPGSLYLAKTSTLPRISLKAAVGGQVPSACSHKQLYTYGVSKHCIKINSKNAESFQFHTEDYFGKESLWTGKGIQLADGGWLIPSNDGKAGKEEFYRALCDTPGVDPKLISRIWVYNHYRWIIWKLAAMECAFPKEFANRCLSPERVLLQLKYRYDTEIDRSRRSAIKKIMERDDTAAKTLVLCVSDIISLSANISETSSNKTSSADTQKVAIIELTDGWYAVKAQLDPPLLAVLKNGRLTVGQKIILHGAELVGSPDACTPLEAPESLMLKISANSTRPARWYTKLGFFPDPRPFPLPLSSLFSDGGNVGCVDVIIQRAYPIQWMEKTSSGLYIFRNEREEEKEAAKYVEAQQKRLEALFTKIQEEFEEHEENTTKPYLPSRALTRQQVRALQDGAELYEAVKNAADPAYLEGYFSEEQLRALNNHRQMLNDKKQAQIQLEIRKAMESAEQKEQGLSRDVTTVWKLRIVSYSKKEKDSVILSIWRPSSDLYSLLTEGKRYRIYHLATSKSKSKSERANIQLAATKKTQYQQLPVSDEILFQIYQPREPLHFSKFLDPDFQPSCSEVDLIGFVVSVVKKTGLAPFVYLSDECYNLLAIKFWIDLNEDIIKPHMLIAASNLQWRPESKSGLLTLFAGDFSVFSASPKEGHFQETFNKMKNTVENIDILCNEAENKLMHILHANDPKWSTPTKDCTSGPYTAQIIPGTGNKLLMSSPNCEIYYQSPLSLCMAKRKSVSTPVSAQMTSKSCKGEKEIDDQKNCKKRRALDFLSRLPLPPPVSPICTFVSPAAQKAFQPPRSCGTKYETPIKKKELNSPQMTPFKKFNEISLLESNSIADEELALINTQALLSGSTGEKQFISVSESTRTAPTSSEDYLRLKRRCTTSLIKEQESSQASTEECEKNKQDTITTKKYI","truncated":false},"meta":{"timestamp":"2026-06-01T08:14:25.277Z","request_id":"29641302-7117-4190-b5e8-f834ecb69efe"},"status":"ok","message":"Sequence retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/assembly":{"get":{"operationId":"get_v1_assembly","tags":["Genome"],"summary":"Genome-assembly metadata","description":"","parameters":[{"name":"species","in":"query","required":false,"description":"Species (default human)","schema":{"type":"string"},"example":"human"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"species":"human","assembly":{"date":"2013-12","name":"GRCh38.p14","accession":"GCA_000001405.29","karyotype":["1","2","3","4","5","6","7","8","9","10","11","12","13","14","15","16","17","18","19","20","21","22","X","Y","MT"],"chromosomes":[{"name":"Y","length":57227415},{"name":"20","length":64444167},{"name":"X","length":156040895},{"name":"13","length":114364328},{"name":"22","length":50818468},{"name":"10","length":133797422},{"name":"6","length":170805979},{"name":"19","length":58617616},{"name":"14","length":107043718},{"name":"18","length":80373285},{"name":"2","length":242193529},{"name":"4","length":190214555},{"name":"21","length":46709983},{"name":"9","length":138394717},{"name":"11","length":135086622},{"name":"17","length":83257441},{"name":"8","length":145138636},{"name":"7","length":159345973},{"name":"15","length":101991189},{"name":"12","length":133275309},{"name":"1","length":248956422},{"name":"16","length":90338345},{"name":"5","length":181538259},{"name":"3","length":198295559},{"name":"MT","length":16569}],"genebuild_method":"full_genebuild","top_level_region_count":194,"default_coord_system_version":"GRCh38"}},"meta":{"timestamp":"2026-06-01T08:14:25.426Z","request_id":"53bb09b6-6594-4bf2-b4d4-b22747856b2b"},"status":"ok","message":"Assembly retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The Ensembl genome database. /v1/gene?species=human&symbol=BRCA2 (add expand=1 for transcripts) = a gene's stable id, biotype, location & description; /v1/lookup?id=ENSG00000139618 = any feature by Ensembl stable id (gene/transcript/exon); /v1/xrefs?species=human&symbol=BRCA2 = external database cross-references; /v1/variant?species=human&id=rs699 = a sequence variant (alleles, consequence, minor-allele frequency, clinical significance, genomic mappings); /v1/region?species=human&region=17:43044295-43125483&feature=gene = features overlapping a genomic region (max 1 Mb; feature=gene|transcript|exon|variation|repeat|cds); /v1/sequence?id=ENSP00000369497&type=protein = the genomic|cds|cdna|protein sequence; /v1/assembly?species=human = genome-assembly metadata (assembly name, accession, karyotype, chromosomes). Species accept common names (human, mouse) or binomials (homo_sapiens). 300+ vertebrate species. Data courtesy of Ensembl / EMBL-EBI.","source":"Ensembl REST API (rest.ensembl.org)","endpoints":["/v1/gene","/v1/lookup","/v1/xrefs","/v1/variant","/v1/region","/v1/sequence","/v1/assembly","/v1/meta"]},"meta":{"timestamp":"2026-06-01T08:14:25.482Z","request_id":"abae661b-5220-48ca-b3d1-70d483bbfd1f"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":740,"monthly_call_quota":18000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2250,"monthly_call_quota":85000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6200,"monthly_call_quota":320000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ensembl-api"}