Ensembl REST API Endpoints

Archive

ResourceDescription
GET archive/id/:id Uses the given identifier to return the archived sequence
POST archive/id Retrieve the archived sequence for a set of identifiers

Comparative Genomics

ResourceDescription
GET genetree/id/:id Retrieves a gene tree for a gene tree stable identifier
GET genetree/member/id/:id Retrieves the gene tree that contains the gene / transcript / translation stable identifier
GET genetree/member/symbol/:species/:symbol Retrieves the gene tree that contains the gene identified by a symbol
GET alignment/region/:species/:region Retrieves genomic alignments as separate blocks based on a region and species
GET homology/id/:id Retrieves homology information (orthologs) by Ensembl gene id
GET homology/symbol/:species/:symbol Retrieves homology information (orthologs) by symbol

Cross References

ResourceDescription
GET xrefs/symbol/:species/:symbol Looks up an external symbol and returns all Ensembl objects linked to it. This can be a display name for a gene/transcript/translation, a synonym or an externally linked reference. If a gene's transcript is linked to the supplied symbol the service will return both gene and transcript (it supports transient links).
GET xrefs/id/:id Perform lookups of Ensembl Identifiers and retrieve their external references in other databases
GET xrefs/name/:species/:name Performs a lookup based upon the primary accession or display label of an external reference and returning the information we hold about the entry

EQTL

ResourceDescription
GET eqtl/stable_id/:species/:stable_id Returns the p-value for each SNP in a given gene (e.g. ENSG00000227232)
GET eqtl/variant_name/:species/:variant_name Returns the p-values for a SNP (e.g. rs123)
GET eqtl/tissue/:species/ Returns all tissues currently available in the DB

Information

ResourceDescription
GET info/analysis/:species List the names of analyses involved in generating Ensembl data.
GET info/assembly/:species List the currently available assemblies for a species, along with toplevel sequences, chromosomes and cytogenetic bands.
GET info/assembly/:species/:region_name Returns information about the specified toplevel sequence region for the given species.
GET info/biotypes/:species List the functional classifications of gene models that Ensembl associates with a particular species. Useful for restricting the type of genes/transcripts retrieved by other endpoints.
GET info/compara/methods List all compara analyses available (an analysis defines the type of comparative data).
GET info/compara/species_sets/:method List all collections of species analysed with the specified compara method.
GET info/comparas Lists all available comparative genomics databases and their data release.
GET info/data Shows the data releases available on this REST server. May return more than one release (unfrequent non-standard Ensembl configuration).
GET info/external_dbs/:species Lists all available external sources for a species.
GET info/ping Checks if the service is alive.
GET info/rest Shows the current version of the Ensembl REST API.
GET info/software Shows the current version of the Ensembl API used by the REST server.
GET info/species Lists all available species, their aliases, available adaptor groups and data release.
GET info/variation/:species List the variation sources used in Ensembl for a species.
GET info/variation/populations/:species List all populations for a species

Linkage Disequilibrium

ResourceDescription
GET ld/:species/:id/:d_prime/:r2/:population_name/:window_size Computes and returns LD values between the given variant and all other variants in a window centered around the given variant. The window size is set to 500 kb.
GET ld/:species/pairwise/:id1:/id2/:d_prime/:r2/:population_name Computes and returns LD values between the given variants.
GET ld/:species/region/:region/:d_prime/:r2/:population_name Computes and returns LD values between all pairs of variants in the defined region.

Lookup

ResourceDescription
GET lookup/id/:id Find the species and database for a single identifier e.g. gene, transcript, protein
POST lookup/id Find the species and database for several identifiers. IDs that are not found are returned with no data.
GET lookup/symbol/:species/:symbol Find the species and database for a symbol in a linked external database
POST lookup/symbol/:species/:symbol Find the species and database for a set of symbols in a linked external database. Unknown symbols are omitted from the response.

Mapping

ResourceDescription
GET map/cdna/:id/:region Convert from cDNA coordinates to genomic coordinates. Output reflects forward orientation coordinates as returned from the Ensembl API.
GET map/cds/:id/:region Convert from CDS coordinates to genomic coordinates. Output reflects forward orientation coordinates as returned from the Ensembl API.
GET map/:species/:asm_one/:region/:asm_two Convert the co-ordinates of one assembly to another
GET map/translation/:id/:region Convert from protein (translation) coordinates to genomic coordinates. Output reflects forward orientation coordinates as returned from the Ensembl API.

Ontologies and Taxonomy

ResourceDescription
GET ontology/ancestors/:id Reconstruct the entire ancestry of a term from is_a and part_of relationships
GET ontology/ancestors/chart/:id Reconstruct the entire ancestry of a term from is_a and part_of relationships.
GET ontology/descendants/:id Find all the terms descended from a given term. By default searches are conducted within the namespace of the given identifier
GET ontology/id/:id Search for an ontological term by its namespaced identifier
GET ontology/name/:name Search for a list of ontological terms by their name
GET taxonomy/classification/:id Return the taxonomic classification of a taxon node
GET taxonomy/id/:id Search for a taxonomic term by its identifier or name
GET taxonomy/name/:name Search for a taxonomic id by a non-scientific name

Overlap

ResourceDescription
GET overlap/id/:id Retrieves features (e.g. genes, transcripts, variants and more) that overlap a region defined by the given identifier.
GET overlap/region/:species/:region Retrieves features (e.g. genes, transcripts, variants and more) that overlap a given region.
GET overlap/translation/:id Retrieve features related to a specific Translation as described by its stable ID (e.g. domains, variants).

Regulation

ResourceDescription
GET regulatory/:species/:id Returns a RegulatoryFeature given its stable ID (e.g. ENSR00001885035)

Sequence

ResourceDescription
GET sequence/id/:id Request multiple types of sequence by stable identifier. Supports feature masking and expand options.
POST sequence/id Request multiple types of sequence by a stable identifier list.
GET sequence/region/:species/:region Returns the genomic sequence of the specified region of the given species. Supports feature masking and expand options.
POST sequence/region/:species Request multiple types of sequence by a list of regions.

Transcript Haplotypes

ResourceDescription
GET transcript_haplotypes/:species/:id Computes observed transcript haplotype sequences based on phased genotype data

VEP

ResourceDescription
GET vep/:species/hgvs/:hgvs_notation Fetch variant consequences based on a HGVS notation
GET vep/:species/id/:id Fetch variant consequences based on a variant identifier
POST vep/:species/id Fetch variant consequences for multiple ids
GET vep/:species/region/:region/:allele/ Fetch variant consequences
POST vep/:species/region Fetch variant consequences for multiple regions

Variation

ResourceDescription
GET variation/:species/:id Uses a variant identifier (e.g. rsID) to return the variation features including optional genotype, phenotype and population data
POST variation/:species/ Uses a list of variant identifiers (e.g. rsID) to return the variation features including optional genotype, phenotype and population data

Variation GA4GH

ResourceDescription
GET ga4gh/features/:id Return the GA4GH record for a specific sequence feature given its identifier
POST ga4gh/features/search Return a list of sequence annotation features in GA4GH format
POST ga4gh/callsets/search Return a list of sets of genotype calls for specific samples in GA4GH format
GET ga4gh/callsets/:id Return the GA4GH record for a specific CallSet given its identifier
POST ga4gh/datasets/search Return a list of datasets in GA4GH format
GET ga4gh/datasets/:id Return the GA4GH record for a specific dataset given its identifier
POST ga4gh/featuresets/search Return a list of feature sets in GA4GH format
GET ga4gh/featuresets/:id Return the GA4GH record for a specific featureSet given its identifier
GET ga4gh/variants/:id Return the GA4GH record for a specific variant given its identifier.
POST ga4gh/variantannotations/search Return variant annotation information in GA4GH format for a region on a reference sequence
POST ga4gh/variants/search Return variant call information in GA4GH format for a region on a reference sequence
POST ga4gh/variantsets/search Return a list of variant sets in GA4GH format
GET ga4gh/variantsets/:id Return the GA4GH record for a specific VariantSet given its identifier
POST ga4gh/references/search Return a list of reference sequences in GA4GH format
GET ga4gh/references/:id Return data for a specific reference in GA4GH format by id
POST ga4gh/referencesets/search Return a list of reference sets in GA4GH format
GET ga4gh/referencesets/:id Return data for a specific reference set in GA4GH format
POST ga4gh/variantannotationsets/search Return a list of annotation sets in GA4GH format
GET ga4gh/variantannotationsets/:id Return meta data for a specific annotation set in GA4GH format