Resolve Gene by Cross-Reference
resolve_gene_by_xrefRead-onlyIdempotent
Reverse identifier mapping: given an external database ID (e.g., Ensembl, RefSeq, UniProt), return the corresponding HGNC gene symbol. Supports version suffixes and cross-references.
Instructions
Reverse identifier mapping: find the HGNC gene(s) for an external database id. source is the database (entrez_id/ncbi, ensembl_gene_id, uniprot, refseq, mane_select, omim, ucsc, vega, ccds, mgi, rgd) and value is the id (e.g. source='ensembl_gene_id', value='ENSG00000157764'). A version suffix is tolerated (ENSG00000012048.23 resolves like ENSG00000012048), and a MANE Select transcript (ENST…/NM_…) resolves back to its gene. Signature: resolve_gene_by_xref(source, value, response_mode=).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| value | Yes | The external identifier value to look up (a version suffix is fine). | |
| source | Yes | Cross-reference database. Canonical keys: entrez_id, ensembl_gene_id, uniprot_ids, refseq_accession, mane_select, omim_id, ucsc_id, vega_id, ccds_id, ena, mgd_id, rgd_id. Common synonyms (ncbi, ensembl, uniprot, refseq, mane, omim, mgi, rgd) are also accepted. | |
| response_mode | No | Verbosity: minimal | compact | standard | full (default compact). | compact |