{"openapi":"3.1.0","info":{"title":"Open Tree of Life API","version":"1.0.0","description":"The tree of life as an API — powered by the Open Tree of Life, the project that unifies published phylogenetic trees and taxonomies into a single synthetic tree spanning about 2.3 million named species. Resolve any scientific name to its canonical taxon and Open Tree Taxonomy (OTT) id (cross-referenced to NCBI, GBIF and other sources); read a taxon's classification and full lineage of ancestors up the tree (genus, family, order, class, …); and compute the most recent common ancestor (MRCA) of any set of species — the heart of comparative biology and \"how related are these organisms?\" questions. From Homo sapiens and the great apes to any branch of plants, fungi, animals and microbes, it is ideal for biology, evolution, ecology, education and bioinformatics tools. An evolutionary-tree / phylogenetics reference — distinct from species-occurrence data (biodiversity / GBIF), marine taxonomy (WoRMS) and sequence databases. Open data from the Open Tree of Life project (CC0).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/opentol-api","description":"oanor gateway"}],"tags":[{"name":"Tree of Life"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/match":{"get":{"operationId":"get_v1_match","tags":["Tree of Life"],"summary":"Resolve a name to a taxon (OTT id)","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"A scientific name","schema":{"type":"string"},"example":"Homo sapiens"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"match":{"url":"https://tree.opentreeoflife.org/taxonomy/browse?id=770315","name":"Homo sapiens","rank":"species","flags":["extinct","sibling_higher"],"score":1,"ott_id":770315,"is_synonym":false,"tax_sources":["ncbi:9606","gbif:2436436","irmng:11388931","irmng:10857762"],"unique_name":"Homo sapiens","matched_name":"Homo sapiens","is_approximate":false,"nomenclature_code":"ICZN"},"query":"Homo sapiens","match_count":1},"meta":{"timestamp":"2026-06-01T16:23:12.131Z","request_id":"322682d4-72fc-411f-b73b-7b7a173826d2"},"status":"ok","message":"Name matched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/mrca":{"get":{"operationId":"get_v1_mrca","tags":["Tree of Life"],"summary":"Most recent common ancestor of 2+ taxa","description":"","parameters":[{"name":"ids","in":"query","required":false,"description":"Comma-separated OTT ids (2-25)","schema":{"type":"string"},"example":"770315,158484"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"mrca":{"node_id":"mrcaott83926ott84217","num_tips":19,"synth_tree_id":"opentree16.1","is_named_taxon":false,"nearest_named_taxon":{"url":"https://tree.opentreeoflife.org/taxonomy/browse?id=312031","name":"Homininae","rank":"subfamily","ott_id":312031}},"input_ott_ids":[770315,158484]},"meta":{"timestamp":"2026-06-01T16:23:12.390Z","request_id":"19d729fd-abe0-4876-a47c-8b0ccace030e"},"status":"ok","message":"MRCA retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/taxon":{"get":{"operationId":"get_v1_taxon","tags":["Tree of Life"],"summary":"A taxon: classification & lineage","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"An OTT id (from /v1/match)","schema":{"type":"string"},"example":"770315"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"taxon":{"url":"https://tree.opentreeoflife.org/taxonomy/browse?id=770315","name":"Homo sapiens","rank":"species","flags":["extinct","sibling_higher"],"ott_id":770315,"lineage":[{"name":"Homo","rank":"genus","ott_id":770309},{"name":"Homininae","rank":"subfamily","ott_id":312031},{"name":"Hominidae","rank":"family","ott_id":770311},{"name":"Hominoidea","rank":"superfamily","ott_id":386191},{"name":"Catarrhini","rank":"parvorder","ott_id":842867},{"name":"Simiiformes","rank":"infraorder","ott_id":386195},{"name":"Haplorrhini","rank":"suborder","ott_id":702152},{"name":"Primates","rank":"no rank","ott_id":913935},{"name":"Primatomorpha","rank":"no rank","ott_id":6520519},{"name":"Euarchontoglires","rank":"superorder","ott_id":392222},{"name":"Boreoeutheria","rank":"no rank","ott_id":5334778},{"name":"Eutheria","rank":"no rank","ott_id":683263},{"name":"Theria","rank":"subclass","ott_id":229558},{"name":"Mammalia","rank":"class","ott_id":244265},{"name":"Amniota","rank":"no rank","ott_id":229560},{"name":"Tetrapoda","rank":"superclass","ott_id":229562},{"name":"Dipnotetrapodomorpha","rank":"no rank","ott_id":4940726},{"name":"Sarcopterygii","rank":"superclass","ott_id":458402},{"name":"Euteleostomi","rank":"no rank","ott_id":114654},{"name":"Teleostomi","rank":"no rank","ott_id":114656},{"name":"Gnathostomata","rank":"superclass","ott_id":278114},{"name":"Vertebrata","rank":"subphylum","ott_id":801601},{"name":"Craniata","rank":"subphylum","ott_id":947318},{"name":"Chordata","rank":"phylum","ott_id":125642},{"name":"Deuterostomia","rank":"no rank","ott_id":147604},{"name":"Bilateria","rank":"no rank","ott_id":117569},{"name":"Eumetazoa","rank":"no rank","ott_id":641038},{"name":"Metazoa","rank":"kingdom","ott_id":691846},{"name":"Holozoa","rank":"no rank","ott_id":5246131},{"name":"Opisthokonta","rank":"no rank","ott_id":332573},{"name":"Eukaryota","rank":"domain","ott_id":304358},{"name":"cellular organisms","rank":"no rank","ott_id":93302},{"name":"life","rank":"no rank","ott_id":805080}],"synonyms":["Homo aethiopicus","Homo americanus","Homo arabicus","Homo aurignacensis","Homo australasicus","Homo cafer","Homo capensis","Homo columbicus","Homo cro-magnonensis","Homo dawsoni","Homo drennani","Homo eurafricanus","Homo floresiensis","Homo fossilis protoaethiopicus","Homo grimaldiensis","Homo grimaldii","Homo helmei","Homo hottentotus","Homo hyperboreus","Homo indicus","Homo japeticus","Homo kanamensis","Homo melaninus","Homo monstrosus","Homo neptunianus"],"tax_sources":["ncbi:9606","gbif:2436436","irmng:11388931","irmng:10857762"],"unique_name":"Homo sapiens","synonym_count":36}},"meta":{"timestamp":"2026-06-01T16:23:12.656Z","request_id":"e5abab5d-272c-4397-8884-01ebb296a0dc"},"status":"ok","message":"Taxon retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Endpoint catalogue & notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The Open Tree of Life unifies published phylogenetic trees and taxonomies into one synthetic tree of all life — about 2.3 million named species, each with an Open Tree Taxonomy (OTT) id cross-referenced to NCBI, GBIF and other sources. /v1/match?name=Homo sapiens = resolve a scientific name (or a recognised synonym) to its canonical taxon, returning the OTT id, accepted/unique name, rank, match score, whether it is a synonym/approximate match, and source ids; /v1/taxon?id=770315 = a taxon's classification — name, rank, source ids, synonyms and its full lineage of ancestors (genus, family, order, …) up the tree; /v1/mrca?ids=770315,158484 = the most recent common ancestor of two or more taxa (give OTT ids from /v1/match), returning the MRCA node, the number of descendant tips and the nearest named clade. OTT ids look like 770315 (Homo sapiens); get them from /v1/match. Data from the Open Tree of Life project (CC0). An evolutionary-tree / phylogenetics reference — distinct from species-occurrence (biodiversity/GBIF), marine-taxonomy (WoRMS) and sequence databases. Ideal for biology, evolution, education and bioinformatics tools.","source":"Open Tree of Life (opentreeoflife.org)","endpoints":["/v1/match","/v1/taxon","/v1/mrca","/v1/meta"]},"meta":{"timestamp":"2026-06-01T16:23:12.744Z","request_id":"eed8ab37-3a1a-4bf5-ba34-dba8f8a2250d"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2600,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":710,"monthly_call_quota":53000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2250,"monthly_call_quota":245000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5950,"monthly_call_quota":870000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/opentol-api"}