mitomap.org APImitomap.org ↗
Access MITOMAP's rRNA/tRNA and coding region mutations, position-level variant search, and GenBank frequency stats via 4 structured JSON endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/202effad-6cdd-4532-8f3d-025b39656ef1/get_rna_mutations_table' \ -H 'X-API-Key: $PARSE_API_KEY'
Extract all RNA mutation data from the MutationsRNA table. Returns the full set of rRNA/tRNA mutations with associated disease, status, and frequency information.
No input parameters required.
{
"type": "object",
"fields": {
"count": "integer total number of RNA mutations returned",
"mutations": "array of RNA mutation objects with position, locus, disease, allele, rna_type, homoplasmy, heteroplasmy, status, mitotip_score, and gb_frequency"
},
"sample": {
"data": {
"count": 487,
"mutations": [
{
"locus": "MT-TF",
"allele": "T578C",
"status": "Reported [VUS-]",
"disease": "Unspecified patient from clinical lab / MS",
"position": 578,
"rna_type": "tRNA Phe",
"homoplasmy": "nr",
"gb_frequency": "0.000%(0.000%)",
"heteroplasmy": "+",
"mitotip_score": "78.30%"
}
]
},
"status": "success"
}
}About the mitomap.org API
The MITOMAP API exposes 4 endpoints covering the full breadth of the MITOMAP mitochondrial DNA database, including rRNA/tRNA mutations, coding and control region pathogenic variants, and per-position variant lookups. The get_rna_mutations_by_position endpoint accepts any mtDNA position from 1 to 16569 and returns allele frequencies from MITOMAP, gnomAD, and HelixMTdb alongside conservation scores, making it practical for targeted variant interrogation.
RNA and Coding Mutation Tables
Two bulk-fetch endpoints cover the primary MITOMAP mutation catalogs. get_rna_mutations_table returns the complete MutationsRNA table as an array of objects, each carrying fields such as position, locus, disease, allele, rna_type, homoplasmy, heteroplasmy, status, mitotip_score, and associated annotations. get_coding_mutations_table targets the MutationsCodingControl table and returns locus, allele, position, nucleotide_change, amino_acid_change, plasmy, disease, and status for confirmed and reported pathogenic variants in protein-coding genes and the control region. Both endpoints return a count integer alongside the mutations array so you can validate completeness without counting rows yourself.
Position-Based Variant Search
get_rna_mutations_by_position accepts a single required parameter — position (a string representing an mtDNA nucleotide position, 1–16569) — and returns a variants array with per-variant fields including nucleotide_change, mitomap_frequency, gnomad_frequency, helix_frequency, and conservation scores. The response also echoes back position_queried for straightforward result validation. This endpoint is useful when you have a candidate position from a sequencing pipeline and want to cross-reference it against multiple population frequency sources in one call.
GenBank Frequency Context
get_genbank_frequency_info retrieves summary statistics about the GenBank sequence dataset underlying MITOMAP's frequency calculations. It returns a stats object of key-value pairs extracted from statistical tables and a summary_preview string containing the first 1500 characters of the frequency information page. This provides the denominator context needed to interpret allele frequencies returned by other endpoints.
- Cross-referencing a candidate mtDNA variant against MITOMAP disease associations using
get_rna_mutations_by_positionwith a specific nucleotide position - Building a local mirror of all confirmed pathogenic coding-region mutations by polling
get_coding_mutations_tableand filtering on thestatusfield - Comparing population frequencies across MITOMAP, gnomAD, and HelixMTdb for variants returned by the position search endpoint
- Extracting MitoTIP scores from
get_rna_mutations_tableto prioritize tRNA variants in a mitochondrial disease gene panel - Auditing homoplasmy vs. heteroplasmy annotations for all RNA mutations to support variant classification workflows
- Retrieving GenBank dataset size and statistics to normalize allele frequency calculations in downstream analysis scripts
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does MITOMAP provide an official developer API?+
What does `get_rna_mutations_by_position` return beyond basic variant info?+
variants array where each object includes nucleotide_change, locus, mitomap_frequency, gnomad_frequency, helix_frequency, and conservation scores — giving you three independent population frequency sources and a conservation signal in a single response. The position_queried field echoes back the input so responses are self-documenting.Can I filter the mutation tables by disease or status through these endpoints?+
get_rna_mutations_table and get_coding_mutations_table) return all records without server-side filtering; fields like disease, status, homoplasmy, and heteroplasmy are present in each object so you can filter client-side. Server-side filtering by disease or gene is not currently exposed. You can fork this API on Parse and revise it to add filtered query parameters.Does the API cover somatic mtDNA mutations or only germline/inherited variants?+
How current is the data returned by the mutation table endpoints?+
get_genbank_frequency_info endpoint returns a summary_preview that typically notes the GenBank release version used, which can serve as a rough freshness indicator.