{"openapi":"3.1.0","info":{"title":"WoRMS Marine Species API","version":"1.0.0","description":"The World Register of Marine Species (WoRMS) as an API — the authoritative, expert-curated taxonomic register of the world's marine life, maintained by a global network of taxonomists. WoRMS provides the accepted scientific names, naming authorities, taxonomic status and synonymy, full classification and vernacular (common) names for marine species. /v1/search?name=Orcinus orca searches species by scientific name (set fuzzy=true for partial matching, marine_only=true to restrict to marine taxa), returning each match's AphiaID (WoRMS' stable identifier), accepted name, authority, rank, taxonomic status, valid name and higher classification. /v1/species?id=137102 returns a species' full record by AphiaID — name and authority, status, the kingdom-to-genus classification, marine and brackish flags, and citation. /v1/classification?id=137102 returns the complete taxonomic tree from Biota down to the taxon, rank by rank. /v1/vernaculars?id=137102 returns the common names with their language. Get an AphiaID from /v1/search, then look up its details, tree or common names. Ideal for marine biology, fisheries science, ecology, aquaculture and biodiversity-data harmonisation. Data from WoRMS (CC BY). This is authoritative marine taxonomy and nomenclature — distinct from species-occurrence/biodiversity databases (such as GBIF) and from sequence or genome databases.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/worms-api","description":"oanor gateway"}],"tags":[{"name":"Species"},{"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/classification":{"get":{"operationId":"get_v1_classification","tags":["Species"],"summary":"Full taxonomic tree","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"AphiaID, e.g. 137102","schema":{"type":"string"},"example":"137102"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":15,"aphia_id":137102,"classification":[{"name":"Biota","rank":"Superdomain","aphia_id":1},{"name":"Animalia","rank":"Kingdom","aphia_id":2},{"name":"Chordata","rank":"Phylum","aphia_id":1821},{"name":"Vertebrata","rank":"Subphylum","aphia_id":146419},{"name":"Gnathostomata","rank":"Infraphylum","aphia_id":1828},{"name":"Tetrapoda","rank":"Megaclass","aphia_id":1831},{"name":"Mammalia","rank":"Class","aphia_id":1837},{"name":"Theria","rank":"Subclass","aphia_id":380416},{"name":"Cetartiodactyla","rank":"Order","aphia_id":370511},{"name":"Cetancodonta","rank":"Suborder","aphia_id":370545},{"name":"Cetacea","rank":"Infraorder","aphia_id":2688},{"name":"Odontoceti","rank":"Superfamily","aphia_id":148723},{"name":"Delphinidae","rank":"Family","aphia_id":136980},{"name":"Orcinus","rank":"Genus","aphia_id":137021},{"name":"Orcinus orca","rank":"Species","aphia_id":137102}]},"meta":{"timestamp":"2026-06-01T16:23:23.184Z","request_id":"87197c18-1e5e-49d0-946c-145215a5389d"},"status":"ok","message":"Classification 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/search":{"get":{"operationId":"get_v1_search","tags":["Species"],"summary":"Search marine species by name","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Scientific name, e.g. Orcinus orca","schema":{"type":"string"},"example":"Orcinus orca"},{"name":"fuzzy","in":"query","required":false,"description":"true for partial matching","schema":{"type":"string"}},{"name":"marine_only","in":"query","required":false,"description":"true to restrict to marine","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"query":"Orcinus orca","species":[{"url":"https://www.marinespecies.org/aphia.php?p=taxdetails&id=137102","rank":"Species","class":"Mammalia","genus":"Orcinus","order":"Cetartiodactyla","family":"Delphinidae","phylum":"Chordata","status":"accepted","kingdom":"Animalia","aphia_id":137102,"authority":"(Linnaeus, 1758)","is_marine":true,"valid_name":"Orcinus orca","valid_aphia_id":137102,"scientific_name":"Orcinus orca"}]},"meta":{"timestamp":"2026-06-01T16:23:23.335Z","request_id":"55e75af1-dc93-4a59-aef3-e76380964f56"},"status":"ok","message":"Search results 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/species":{"get":{"operationId":"get_v1_species","tags":["Species"],"summary":"A species record by AphiaID","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"AphiaID (from /v1/search), e.g. 137102","schema":{"type":"string"},"example":"137102"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"species":{"url":"https://www.marinespecies.org/aphia.php?p=taxdetails&id=137102","lsid":"urn:lsid:marinespecies.org:taxname:137102","rank":"Species","class":"Mammalia","genus":"Orcinus","order":"Cetartiodactyla","family":"Delphinidae","phylum":"Chordata","status":"accepted","kingdom":"Animalia","aphia_id":137102,"citation":"Fordyce, E.; Perrin, W.F. (2026). World Cetacea Database. Orcinus orca (Linnaeus, 1758). Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=137102 on 2026-06-01","modified":"2008-08-20T11:25:36.853Z","authority":"(Linnaeus, 1758)","is_marine":true,"valid_name":"Orcinus orca","valid_aphia_id":137102,"scientific_name":"Orcinus orca"}},"meta":{"timestamp":"2026-06-01T16:23:23.508Z","request_id":"4c22b839-2567-4a85-a8b5-4a019567c82d"},"status":"ok","message":"Species 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/vernaculars":{"get":{"operationId":"get_v1_vernaculars","tags":["Species"],"summary":"Common names by language","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"AphiaID, e.g. 137102","schema":{"type":"string"},"example":"137102"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":106,"aphia_id":137102,"vernaculars":[{"name":"adluk","language":"Inuktitut"},{"name":"aguluk","language":"Aleut"},{"name":"ardlursark","language":"Kalaallisut"},{"name":"ardlyk","language":"Kalaallisut"},{"name":"baleia asesina","language":"Portuguese"},{"name":"ballena asesina","language":"Spanish"},{"name":"ballena pinta","language":"Spanish"},{"name":"ballena quila","language":"Spanish"},{"name":"beom-gorae","language":"Korean"},{"name":"botskop","language":"Dutch"},{"name":"bovhidehval","language":"Faroese"},{"name":"bufeo de mascarilla","language":"Spanish"},{"name":"cahuel-huaique","language":"Spanish"},{"name":"delfin gigante","language":"Spanish"},{"name":"dorque","language":"French"},{"name":"dukulad","language":"Aleut"},{"name":"epaulard","language":"French"},{"name":"epée de mer","language":"French"},{"name":"espadarte","language":"Spanish"},{"name":"ezpalarta","language":"Basque"},{"name":"fann-fiskar-hydengen","language":"Icelandic"},{"name":"grampus","language":"English"},{"name":"großer Schwertwal","language":"German"},{"name":"haa-hirningur","language":"Icelandic"},{"name":"hahyrna","language":"Icelandic"},{"name":"hahyrningur","language":"Icelandic"},{"name":"huyding","language":"Icelandic"},{"name":"hvalhund","language":"Norwegian"},{"name":"innuatu","language":"Korean"},{"name":"kasatka","language":"Russian"},{"name":"katil balina","language":"Turkish"},{"name":"killer whale","language":"English"},{"name":"killer-trasher","language":"English"},{"name":"kosatka","language":"Russian"},{"name":"kosatka dravá","language":"Czech"},{"name":"kosаtkа","language":"Bulgarian"},{"name":"lleiddiad","language":"Welsh"},{"name":"löpare","language":"Swedish"},{"name":"machete","language":"Spanish"},{"name":"marzupla","language":"Basque"},{"name":"mesungesak","language":"Yupik languages"},{"name":"moordvis","language":"Afrikaans"},{"name":"moscote","language":"Spanish"},{"name":"musonkjgyssiak","language":"Chukot"},{"name":"nookur","language":"Anus"},{"name":"opare","language":"Swedish"},{"name":"orca","language":"English"},{"name":"orca","language":"Spanish"},{"name":"orca","language":"Portuguese"},{"name":"Orca","language":"German"},{"name":"orca  ","language":"Italian"},{"name":"orca","language":"Dutch"},{"name":"orca","language":"Catalan"},{"name":"orca común","language":"Spanish"},{"name":"orca gwryw","language":"Welsh"},{"name":"orca verdadera","language":"Spanish"},{"name":"orka","language":"Lithuanian"},{"name":"orka","language":"Polish"},{"name":"orka","language":"Slovenian"},{"name":"orka","language":"Dutch"},{"name":"orka","language":"Basque"},{"name":"ornswin","language":"Danish"},{"name":"orque","language":"French"},{"name":"orque épaulard","language":"French"},{"name":"orque gladiateur","language":"French"},{"name":"paus pemangsa","language":"Indonesian"},{"name":"pictwale","language":"Scottish Gaelic"},{"name":"plawan phechakhat","language":"Thai"},{"name":"roaz-de-bandeira","language":"Portuguese"},{"name":"sadshi","language":"Japanese"},{"name":"sakamata","language":"Japanese"},{"name":"Schwertwal","language":"German"},{"name":"seguni","language":"Indonesian"},{"name":"shachi","language":"Japanese"},{"name":"spackhuggare","language":"Swedish"},{"name":"späckhuggare","language":"Swedish"},{"name":"spaekhogger","language":"Danish"},{"name":"spaekhogger","language":"Norwegian"},{"name":"spækhugger","language":"Danish"},{"name":"spekkhoggar","language":"Norwegian Nynorsk"},{"name":"spekkhogger","language":"Norwegian Bokmål"},{"name":"spekkhugger","language":"Norwegian"},{"name":"starhyn ning","language":"Norwegian"},{"name":"staurhval","language":"Norwegian"},{"name":"stourvaga","language":"Norwegian"},{"name":"stourvagn","language":"Norwegian"},{"name":"svaerdval","language":"Danish"},{"name":"svärdfisk","language":"Swedish"},{"name":"svarthval","language":"Danish"},{"name":"sverdfiscur","language":"Icelandic"},{"name":"sword grampus","language":"English"},{"name":"swordfish","language":"English"},{"name":"taka","language":"Japanese"},{"name":"takamatsu","language":"Japanese"},{"name":"tandthoye","language":"Danish"},{"name":"trozona mpamond","language":"Malagasy"},{"name":"tunnlik tumlare","language":"Swedish"},{"name":"vaghund","language":"Norwegian"},{"name":"van hund","language":"Norwegian"},{"name":"zwaardwalvis","language":"Dutch"},{"name":"Όρκα","language":"Modern Greek (1453-)"},{"name":"или кит убийца","language":"Russian"},{"name":"косатка","language":"Russian"},{"name":"Косатка","language":"Ukrainian"},{"name":"Косатка","language":"Bulgarian"},{"name":"シャチ","language":"Japanese"}]},"meta":{"timestamp":"2026-06-01T16:23:23.827Z","request_id":"c0b7459c-41e4-432c-84da-ad352509f240"},"status":"ok","message":"Vernaculars 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":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"WoRMS is the authoritative, expert-curated taxonomic register of the world's marine species. /v1/search?name=Orcinus orca = search species by scientific name (fuzzy=true for partial matching, marine_only=true to restrict), returning each match's AphiaID, accepted name, authority, rank, taxonomic status, valid name and higher classification; /v1/species?id=137102 = a species' full record by AphiaID — name, authority, status, the kingdom-to-genus classification, marine/brackish flags and citation; /v1/classification?id=137102 = the complete taxonomic tree from Biota down to the taxon, rank by rank; /v1/vernaculars?id=137102 = the common (vernacular) names with their language codes. AphiaID is WoRMS' stable identifier (get it from /v1/search). Data from WoRMS (CC BY). This is authoritative marine taxonomy & nomenclature — distinct from species-occurrence/biodiversity databases (GBIF) and from sequence/genome databases. Ideal for marine biology, fisheries, ecology and biodiversity-data harmonisation.","source":"WoRMS — World Register of Marine Species (marinespecies.org)","endpoints":["/v1/search","/v1/species","/v1/classification","/v1/vernaculars","/v1/meta"]},"meta":{"timestamp":"2026-06-01T16:23:23.880Z","request_id":"76614337-0c7d-4e0f-8b4b-a7f53d2b5406"},"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":2350,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":650,"monthly_call_quota":49500,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1950,"monthly_call_quota":219000,"rps_limit":12,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5250,"monthly_call_quota":788000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/worms-api"}