GET /xrefs/symbol/{species}/{symbol}

ensembl.org:ensembl-rest-api

Summary: Lookup external symbol
Operation ID: getXrefsBySymbol
Auth: none

Find Ensembl features by an external database symbol. This is the reverse of the ID xref endpoint - provide a symbol from an external database (like a UniProt accession or HGNC symbol) and get back Ensembl IDs. Use for converting between database identifiers when you have the external symbol.

Original spec description

Looks up an external symbol and returns all Ensembl objects linked to it.

Usage Tips

- Returns all Ensembl features that have this symbol as an external reference - May return multiple features if the symbol maps ambiguously - The `db_name` field in results tells you which database the symbol came from - Use with `?external_db=HGNC` to restrict to HGNC symbols only - Results include the Ensembl ID, display label, and description

Parameters (3)

db_type (string, query, optional)

External database to search

species (string, path, required)

Species name

symbol (string, path, required)

External symbol to look up

Examples (1)

TitleTypeURLAction
Lookup BRCA2 by external symbol probe-gate https://rest.ensembl.org/xrefs/symbol/homo_sapiens/BRCA2?content-type=application/json

No probe data for this endpoint yet.