Get Meta-Domain Variants
get_meta_domainRead-onlyIdempotent
Retrieve homologous variant evidence (gnomAD and ClinVar) for a protein residue across its Pfam domain family, using transcript ID and position.
Instructions
Return homologous (meta-domain) variant evidence for one residue: gnomAD normal_variants and ClinVar pathogenic_variants observed at the aligned consensus position across the residue's Pfam domain family, each carrying its homolog gene_name. Omit domains to derive the selector from the residue's cached domain mapping; a residue with no meta-domain returns empty lists (not an error). Requires a built landscape. Signature: get_meta_domain(transcript_id=, position=, domains=, limit=, offset=, response_mode=).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| transcript_id | Yes | A versioned Ensembl transcript id (the .N version suffix is required), e.g. ENST00000269305.4. Resolve a gene symbol with resolve_transcript first. | |
| position | Yes | 1-based protein residue position. | |
| domains | No | Optional meta-domain selector {PfamID: [consensus_pos, ...]}. Omit to derive it from the residue's cached domain mapping. | |
| limit | No | Maximum rows to return (1..1000; default 200). | |
| offset | No | Zero-based offset into the result list (for paging). | |
| response_mode | No | Verbosity: minimal|compact|standard|full (default compact). | compact |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | Yes | ||
| _meta | No | ||
| error_code | No | ||
| message | No | ||
| retryable | No | ||
| recovery_action | No | ||
| field | No | ||
| hint | No | ||
| candidates | No | ||
| recommended_citation | No | ||
| data_versions | No | ||
| transcript_id | No | ||
| protein_position | No | ||
| requested_domains | No | ||
| meta_domains | No |