WoRMS
App · 20 actions
The World Register of Marine Species: look up the accepted scientific name and AphiaID of any marine species, fix misspelled names with fuzzy matching, and get a taxon's classification, synonyms, common names, distribution, traits, sources and IDs in other databases. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Find AphiaID by name | Get the AphiaID, WoRMS's permanent number for a taxon, of an exact scientific name. |
| Find taxon by external ID | Find the WoRMS taxon another database's id belongs to, such as an ITIS TSN or an NCBI Taxonomy ID. |
| Get classification | Get a taxon's full classification, every rank from Biota down to the taxon itself (including suborders, superfamilies and the like), each with its AphiaID. |
| Get external IDs | Get a taxon's id in another database WoRMS links to: ITIS, NCBI (GenBank), BOLD, FishBase, AlgaeBase, the IUCN Red List, Dyntaxa or the Global Invasive Species Database. |
| Get taxon | Get a taxon's WoRMS record by its AphiaID: its name and author, rank, whether the name is accepted (and the accepted name if not), its kingdom to genus, where it lives, and how to cite it. |
| List attribute definitions | List the traits WoRMS can record (body size, IUCN Red List category, functional group and more) and the qualifiers each one takes, with the value list each draws on. |
| List attribute values | List the values an attribute can take, such as the IUCN Red List categories or the life stages, with their codes. |
| List attributes | List the traits WoRMS records for a taxon, such as body size, IUCN Red List category, functional group or listing in a directive, each with its qualifiers and a one-line summary. |
| List changed taxa | List the taxa added to WoRMS or last changed in a period, oldest change first, such as names newly described, moved or found to be synonyms. |
| List child taxa | List a taxon's direct children: the genera in a family, the species in a genus, and so on, in alphabetical order, accepted and unaccepted names alike. |
| List common names | List a taxon's common names, such as Atlantic cod or kabeljauw, with their languages, optionally in one language. |
| List distributions | List where a taxon is recorded, by sea area or country, with whether each record is reliable and, for introduced species, whether it is native or alien there. |
| List sources | List the references WoRMS cites for a taxon, such as its original description, with page numbers, DOIs and links. |
| List synonyms | List every other name a taxon has been known by (synonyms, old combinations and misspellings), each with why it is not used. |
| List taxa by rank | List every taxon of one rank within a group, such as every species in a family or every genus in an order, however many ranks down. |
| List taxa with attribute | List the taxa that have a trait recorded, such as an IUCN Red List category or a body size, with their names and the trait's values. |
| List taxonomic ranks | List the taxonomic ranks WoRMS uses in each kingdom, from Kingdom down to Forma, with the number WoRMS gives each rank. |
| Match names | Match up to 50 scientific names to WoRMS with TAXAMATCH, which forgives misspellings (Gadus morua finds Gadus morhua). |
| Search by common name | Find the taxa known by a common name in any language, such as killer whale or kabeljauw, with their scientific names. |
| Search taxa by name | Find taxa whose scientific name starts with, or is exactly, the text given, accepted and unaccepted names alike, each with its accepted name. |
Find AphiaID by name
Get the AphiaID, WoRMS's permanent number for a taxon, of an exact scientific name. Says so when no taxon has the name, or when several do (then use Search taxa by name to choose).
Inputs
- Scientific name
nametextRequired - The scientific name, spelled exactly, e.g. Gadus morhua.
- Marine taxa only
marine_onlytrue/false - Only include taxa that live in the sea. WoRMS also lists many freshwater and land taxa; turn this off to include them.Default:
true. - Living taxa only
extant_onlytrue/false - Leave out extinct taxa known only as fossils. Turn off to include them.Default:
true.
Outputs
aphia_idnumber- Its AphiaID, when exactly one taxon has the name.
foundtrue/false- True when exactly one taxon has the name.
nametext- The name looked up.
several_matchestrue/false- True when several taxa share the name, so there is no single AphiaID.
urltext- The taxon's page on marinespecies.org, when found.
Example output
{
"aphia_id": 126436,
"found": true,
"name": "Gadus morhua",
"several_matches": false,
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=126436"
}Find taxon by external ID
Find the WoRMS taxon another database's id belongs to, such as an ITIS TSN or an NCBI Taxonomy ID. Says so when WoRMS links none.
Inputs
- External ID
external_idtextRequired - The id in the other database, e.g. 164712 (an ITIS TSN).
- Database
databasetextRequired - The database the id comes from.One of:
tsn(ITIS Taxonomic Serial Number (TSN)),ncbi(NCBI Taxonomy ID (GenBank)),bold(Barcode of Life (BOLD) TaxID),fishbase(FishBase species ID),algaebase(AlgaeBase species ID),iucn(IUCN Red List ID),dyntaxa(Dyntaxa ID (Swedish Taxonomic Database)),gisd(Global Invasive Species Database ID),lsid(Life Science Identifier (LSID)).
Outputs
databasetext- The database the id is from, e.g. 'tsn'.
database_nametext- The database's name.
external_idtext- The id looked up.
foundtrue/false- True when a WoRMS taxon is linked to the id.
taxonobject- The WoRMS taxon, or empty when none is linked.
Example output
{
"database": "tsn",
"database_name": "ITIS Taxonomic Serial Number (TSN)",
"external_id": "164712",
"found": true,
"taxon": {
"aphia_id": 126436,
"authority": "Linnaeus, 1758",
"citation": "Froese, R. and D. Pauly. Editors. (2026). FishBase. Gadus morhua Linnaeus, 1758. Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=126436 on 2026-10-21",
"class": "Teleostei",
"family": "Gadidae",
"genus": "Gadus",
"is_brackish": true,
"is_extinct": null,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:126436",
"modified": "2008-01-15T17:27:08.177Z",
"order": "Gadiformes",
"original_aphia_id": 126436,
"parent_aphia_id": 125732,
"phylum": "Chordata",
"rank": "Species",
"rank_id": 220,
"scientific_name": "Gadus morhua",
"status": "accepted",
"unaccept_reason": null,
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=126436",
"valid_aphia_id": 126436,
"valid_authority": "Linnaeus, 1758",
"valid_name": "Gadus morhua"
}
}Get classification
Get a taxon's full classification, every rank from Biota down to the taxon itself (including suborders, superfamilies and the like), each with its AphiaID.
Inputs
- AphiaID
aphia_idtextRequired - The taxon's AphiaID, WoRMS's number for it, e.g. 126436 for Atlantic cod. Find it with Find AphiaID by name. The taxon's page address or LSID works too.
Outputs
aphia_idnumber- The taxon's AphiaID, WoRMS's permanent number for it.
classificationlist- Each rank from Biota down to the taxon itself.
countnumber- How many ranks.
pathtext- The ranks as one line, e.g. 'Biota > Animalia > ... > Gadus morhua'.
Example output
{
"aphia_id": 126436,
"classification": [
{
"aphia_id": 1,
"rank": "Superdomain",
"scientific_name": "Biota"
},
{
"aphia_id": 2,
"rank": "Kingdom",
"scientific_name": "Animalia"
},
{
"aphia_id": 1821,
"rank": "Phylum",
"scientific_name": "Chordata"
},
{
"aphia_id": 146419,
"rank": "Subphylum",
"scientific_name": "Vertebrata"
},
{
"aphia_id": 1828,
"rank": "Infraphylum",
"scientific_name": "Gnathostomata"
},
{
"aphia_id": 152352,
"rank": "Parvphylum",
"scientific_name": "Osteichthyes"
},
{
"aphia_id": 10194,
"rank": "Gigaclass",
"scientific_name": "Actinopterygii"
},
{
"aphia_id": 843664,
"rank": "Superclass",
"scientific_name": "Actinopteri"
},
{
"aphia_id": 293496,
"rank": "Class",
"scientific_name": "Teleostei"
},
{
"aphia_id": 10313,
"rank": "Order",
"scientific_name": "Gadiformes"
},
{
"aphia_id": 1865951,
"rank": "Suborder",
"scientific_name": "Gadoidei"
},
{
"aphia_id": 125469,
"rank": "Family",
"scientific_name": "Gadidae"
},
{
"aphia_id": 125732,
"rank": "Genus",
"scientific_name": "Gadus"
},
{
"aphia_id": 126436,
"rank": "Species",
"scientific_name": "Gadus morhua"
}
],
"count": 14,
"path": "Biota > Animalia > Chordata > Vertebrata > Gnathostomata > Osteichthyes > Actinopterygii > Actinopteri > Teleostei > Gadiformes > Gadoidei > Gadidae > Gadus > Gadus morhua"
}Get external IDs
Get a taxon's id in another database WoRMS links to: ITIS, NCBI (GenBank), BOLD, FishBase, AlgaeBase, the IUCN Red List, Dyntaxa or the Global Invasive Species Database.
Inputs
- AphiaID
aphia_idtextRequired - The taxon's AphiaID, WoRMS's number for it, e.g. 126436 for Atlantic cod. Find it with Find AphiaID by name. The taxon's page address or LSID works too.
- Database
databasetextRequired - The database whose id you want.One of:
tsn(ITIS Taxonomic Serial Number (TSN)),ncbi(NCBI Taxonomy ID (GenBank)),bold(Barcode of Life (BOLD) TaxID),fishbase(FishBase species ID),algaebase(AlgaeBase species ID),iucn(IUCN Red List ID),dyntaxa(Dyntaxa ID (Swedish Taxonomic Database)),gisd(Global Invasive Species Database ID),lsid(Life Science Identifier (LSID)).
Outputs
aphia_idnumber- The taxon's AphiaID, WoRMS's permanent number for it.
databasetext- The database asked about, e.g. 'tsn'.
database_nametext- The database's name.
external_idtext- The first id, or empty when there is none.
external_idslist- The taxon's ids there (usually one).
foundtrue/false- True when WoRMS links the taxon to that database.
Example output
{
"aphia_id": 126436,
"database": "tsn",
"database_name": "ITIS Taxonomic Serial Number (TSN)",
"external_id": "164712",
"external_ids": [
"164712"
],
"found": true
}Get taxon
Get a taxon's WoRMS record by its AphiaID: its name and author, rank, whether the name is accepted (and the accepted name if not), its kingdom to genus, where it lives, and how to cite it.
Inputs
- AphiaID
aphia_idtextRequired - The taxon's AphiaID, WoRMS's number for it, e.g. 126436 for Atlantic cod. Find it with Find AphiaID by name. The taxon's page address or LSID works too.
Outputs
aphia_idnumber- The taxon's AphiaID, e.g. 126436.
authoritytext- Who named it and when, e.g. 'Linnaeus, 1758'.
citationtext- How to cite this record, as WoRMS asks (its licence requires it).
classtext- Its class, e.g. 'Teleostei'.
familytext- Its family, e.g. 'Gadidae'.
genustext- Its genus, e.g. 'Gadus'.
is_brackishtrue/false- True if it lives in brackish water.
is_extincttrue/false- True if it is extinct.
is_freshwatertrue/false- True if it lives in fresh water.
is_marinetrue/false- True if it lives in the sea; empty when unknown.
is_terrestrialtrue/false- True if it lives on land.
kingdomtext- Its kingdom, e.g. 'Animalia'.
lsidtext- Its Life Science Identifier, e.g. 'urn:lsid:marinespecies.org:taxname:126436'.
modifiedtext- When the record was last changed, ISO 8601 in UTC.
ordertext- Its order, e.g. 'Gadiformes'.
original_aphia_idnumber- The AphiaID of the name as first published, when known.
parent_aphia_idnumber- The AphiaID of the taxon one rank up (the genus of a species).
phylumtext- Its phylum or division, e.g. 'Chordata'.
ranktext- The rank, e.g. 'Species', 'Genus' or 'Family'.
rank_idnumber- WoRMS's number for the rank, e.g. 220 for Species.
scientific_nametext- The scientific name without its author, e.g. 'Gadus morhua'.
statustext- Whether the name is in use: 'accepted', or 'unaccepted' and its kinds (e.g. 'junior subjective synonym'), 'temporary name', 'nomen dubium' or 'deleted'.
unaccept_reasontext- Why the name is unaccepted, when given.
urltext- The taxon's page on marinespecies.org.
valid_aphia_idnumber- The AphiaID of the accepted name (its own for an accepted taxon).
valid_authoritytext- The accepted name's author and year.
valid_nametext- The accepted name to use instead.
Example output
{
"aphia_id": 126436,
"authority": "Linnaeus, 1758",
"citation": "Froese, R. and D. Pauly. Editors. (2026). FishBase. Gadus morhua Linnaeus, 1758. Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=126436 on 2026-10-21",
"class": "Teleostei",
"family": "Gadidae",
"genus": "Gadus",
"is_brackish": true,
"is_extinct": null,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:126436",
"modified": "2008-01-15T17:27:08.177Z",
"order": "Gadiformes",
"original_aphia_id": 126436,
"parent_aphia_id": 125732,
"phylum": "Chordata",
"rank": "Species",
"rank_id": 220,
"scientific_name": "Gadus morhua",
"status": "accepted",
"unaccept_reason": null,
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=126436",
"valid_aphia_id": 126436,
"valid_authority": "Linnaeus, 1758",
"valid_name": "Gadus morhua"
}List attribute definitions
List the traits WoRMS can record (body size, IUCN Red List category, functional group and more) and the qualifiers each one takes, with the value list each draws on.
Inputs
- Attribute
attribute_idtext - Only this attribute and its qualifiers. Leave empty for every attribute.
- Include qualifiers
include_childrentrue/false - Also list the qualifiers under each attribute, such as a body size's unit and type.Default:
true.
Outputs
countnumber- How many came back.
definitionslist- The definitions, each followed by its qualifiers.
Example output
{
"count": 3,
"definitions": [
{
"category_id": null,
"id": 15,
"level": 1,
"name": "Body size",
"parent_id": null,
"path": "Body size"
},
{
"category_id": 11,
"id": 17,
"level": 2,
"name": "Unit",
"parent_id": 15,
"path": "Body size > Unit"
},
{
"category_id": 14,
"id": 18,
"level": 2,
"name": "Type",
"parent_id": 15,
"path": "Body size > Type"
}
]
}List attribute values
List the values an attribute can take, such as the IUCN Red List categories or the life stages, with their codes.
Inputs
- Value list
category_idtextRequired - The value list to read, named by the attributes that use it.
Outputs
category_idnumber- The value list read.
countnumber- How many came back.
valueslist- The values, each followed by any that refine it.
Example output
{
"category_id": 1,
"count": 3,
"values": [
{
"code": "CR",
"id": 3,
"level": 1,
"parent_id": null,
"value": "Critically Endangered"
},
{
"code": "EN",
"id": 4,
"level": 1,
"parent_id": null,
"value": "Endangered"
},
{
"code": "VU",
"id": 5,
"level": 1,
"parent_id": null,
"value": "Vulnerable"
}
]
}List attributes
List the traits WoRMS records for a taxon, such as body size, IUCN Red List category, functional group or listing in a directive, each with its qualifiers and a one-line summary.
Inputs
- AphiaID
aphia_idtextRequired - The taxon's AphiaID, WoRMS's number for it, e.g. 126436 for Atlantic cod. Find it with Find AphiaID by name. The taxon's page address or LSID works too.
- Include inherited
include_inheritedtrue/false - Also include traits recorded on a higher taxon, such as its genus or family, that apply to this one.Default:
false.
Outputs
aphia_idnumber- The taxon's AphiaID, WoRMS's permanent number for it.
attributeslist- The attributes.
countnumber- How many came back.
Example output
{
"aphia_id": 126436,
"attributes": [
{
"category_id": null,
"details": [
{
"category_id": 11,
"level": 1,
"type": "Unit",
"type_id": 17,
"value": "cm"
},
{
"category_id": 14,
"level": 2,
"type": "Type",
"type_id": 18,
"value": "maximum"
},
{
"category_id": null,
"level": 3,
"type": "Locality (MRGID)",
"type_id": 22,
"value": "1920"
}
],
"inherited_from_aphia_id": null,
"quality_status": "unreviewed",
"reference": "Hayward, P.J. & J.S. Ryland (Eds.). (1990). The marine fauna of the British Isles and North-West Europe: 1. Introduction and protozoans to arthropods. Clarendon Press: Oxford, UK. 627 pp.",
"source_id": 1,
"summary": "Body size: 150 (Unit: cm; Type: maximum; Locality (MRGID): 1920)",
"type": "Body size",
"type_id": 15,
"value": "150"
},
{
"category_id": null,
"details": [
{
"category_id": 11,
"level": 1,
"type": "Unit",
"type_id": 17,
"value": "cm"
},
{
"category_id": 14,
"level": 2,
"type": "Type",
"type_id": 18,
"value": "maximum"
},
{
"category_id": 15,
"level": 3,
"type": "Dimension",
"type_id": 19,
"value": "length"
},
{
"category_id": 12,
"level": 4,
"type": "Sex",
"type_id": 21,
"value": "male/unsexed"
}
],
"inherited_from_aphia_id": null,
"quality_status": "checked",
"reference": "Cohen, D.M.; Inada, T.; Iwamoto, T.; Scialabba, N. (1990). FAO species catalogue. Vol. 10. Gadiform fishes of the world (Order Gadiformes). An annotated and illustrated catalogue of cods, hakes, grenadiers and other gadiform fishes known to date. FAO Fish. Synop. 125(10). Rome: FAO. 442 p.",
"source_id": 231780,
"summary": "Body size: 200 (Unit: cm; Type: maximum; Dimension: length; Sex: male/unsexed)",
"type": "Body size",
"type_id": 15,
"value": "200"
}
],
"count": 2
}List changed taxa
List the taxa added to WoRMS or last changed in a period, oldest change first, such as names newly described, moved or found to be synonyms.
Inputs
- From
startdate and timeRequired - The start of the period.
- Until
enddate and time - The end of the period. Defaults to now.
- Marine taxa only
marine_onlytrue/false - Only include taxa that live in the sea. WoRMS also lists many freshwater and land taxa; turn this off to include them.Default:
true. - Living taxa only
extant_onlytrue/false - Leave out extinct taxa known only as fossils. Turn off to include them.Default:
true. - Number of results
limitnumber - How many taxa to return, 1 to 200. Defaults to 50. WoRMS sends 50 at a time, so more take longer.From 1 to 200.
- Skip
skipnumber - How many to skip first. To get the next ones after an earlier step, use its next_skip. Defaults to 0.From 0 to 100000.
Outputs
countnumber- How many came back in this step.
endtext- The end of the period, in UTC.
has_moretrue/false- True when WoRMS may have more after these.
next_skipnumber- The Skip value that gets the next ones, when there may be more.
starttext- The start of the period, in UTC.
taxalist- The taxa, oldest change first.
Example output
{
"count": 2,
"end": "2026-10-20T00:00:00+00:00",
"has_more": true,
"next_skip": 2,
"start": "2026-10-19T00:00:00+00:00",
"taxa": [
{
"aphia_id": 745692,
"authority": "M\u00f6rch, 1877",
"citation": "MolluscaBase eds. (2026). MolluscaBase. Crypta navicula M\u00f6rch, 1877. Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=745692 on 2026-10-21",
"class": "Gastropoda",
"family": "Calyptraeidae",
"genus": "Crypta",
"is_brackish": false,
"is_extinct": null,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:745692",
"modified": "2026-10-19T00:25:22.497Z",
"order": "Littorinimorpha",
"original_aphia_id": 745692,
"parent_aphia_id": 571628,
"phylum": "Mollusca",
"rank": "Species",
"rank_id": 220,
"scientific_name": "Crypta navicula",
"status": "superseded combination",
"unaccept_reason": null,
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=745692",
"valid_aphia_id": 532685,
"valid_authority": "(M\u00f6rch, 1877)",
"valid_name": "Crepidula navicula"
},
{
"aphia_id": 605364,
"authority": "Barnard, 1963",
"citation": "MolluscaBase eds. (2026). MolluscaBase. Acteocina natalensis Barnard, 1963. Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=605364 on 2026-10-21",
"class": "Gastropoda",
"family": "Tornatinidae",
"genus": "Acteocina",
"is_brackish": false,
"is_extinct": false,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:605364",
"modified": "2026-10-19T07:41:42.543Z",
"order": "Cephalaspidea",
"original_aphia_id": 605366,
"parent_aphia_id": 137866,
"phylum": "Mollusca",
"rank": "Species",
"rank_id": 220,
"scientific_name": "Acteocina natalensis",
"status": "junior subjective synonym",
"unaccept_reason": null,
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=605364",
"valid_aphia_id": 215334,
"valid_authority": "(A. Adams, 1850)",
"valid_name": "Tornatina fusiformis"
}
]
}List child taxa
List a taxon's direct children: the genera in a family, the species in a genus, and so on, in alphabetical order, accepted and unaccepted names alike.
Inputs
- AphiaID
aphia_idtextRequired - The parent taxon's AphiaID, e.g. 125732 for the genus Gadus. The taxon's page address or LSID works too.
- Marine taxa only
marine_onlytrue/false - Only include taxa that live in the sea. WoRMS also lists many freshwater and land taxa; turn this off to include them.Default:
true. - Living taxa only
extant_onlytrue/false - Leave out extinct taxa known only as fossils. Turn off to include them.Default:
true. - Number of results
limitnumber - How many child taxa to return, 1 to 200. Defaults to 50. WoRMS sends 50 at a time, so more take longer.From 1 to 200.
- Skip
skipnumber - How many to skip first. To get the next ones after an earlier step, use its next_skip. Defaults to 0.From 0 to 100000.
Outputs
aphia_idnumber- The taxon's AphiaID, WoRMS's permanent number for it.
childrenlist- The child taxa, alphabetically.
countnumber- How many came back in this step.
has_moretrue/false- True when WoRMS may have more after these.
next_skipnumber- The Skip value that gets the next ones, when there may be more.
Example output
{
"aphia_id": 125732,
"children": [
{
"aphia_id": 300720,
"authority": "Nilsson, 1832",
"citation": "Froese, R. and D. Pauly. Editors. (2026). FishBase. Gadus abyssorum Nilsson, 1832. Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=300720 on 2026-10-21",
"class": "Teleostei",
"family": "Gadidae",
"genus": "Gadus",
"is_brackish": false,
"is_extinct": null,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:300720",
"modified": "2008-02-28T13:41:07.550Z",
"order": "Gadiformes",
"original_aphia_id": 300720,
"parent_aphia_id": 125732,
"phylum": "Chordata",
"rank": "Species",
"rank_id": 220,
"scientific_name": "Gadus abyssorum",
"status": "unaccepted",
"unaccept_reason": null,
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=300720",
"valid_aphia_id": 126459,
"valid_authority": "(Pennant, 1784)",
"valid_name": "Molva dypterygia"
},
{
"aphia_id": 154763,
"authority": "Linnaeus, 1758",
"citation": "Froese, R. and D. Pauly. Editors. (2026). FishBase. Gadus aeglefinus Linnaeus, 1758. Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=154763 on 2026-10-21",
"class": "Teleostei",
"family": "Gadidae",
"genus": "Gadus",
"is_brackish": false,
"is_extinct": null,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:154763",
"modified": "2008-02-28T13:41:07.550Z",
"order": "Gadiformes",
"original_aphia_id": 154763,
"parent_aphia_id": 125732,
"phylum": "Chordata",
"rank": "Species",
"rank_id": 220,
"scientific_name": "Gadus aeglefinus",
"status": "unaccepted",
"unaccept_reason": "basionym",
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=154763",
"valid_aphia_id": 126437,
"valid_authority": "(Linnaeus, 1758)",
"valid_name": "Melanogrammus aeglefinus"
}
],
"count": 2,
"has_more": true,
"next_skip": 2
}List common names
List a taxon's common names, such as Atlantic cod or kabeljauw, with their languages, optionally in one language.
Inputs
- AphiaID
aphia_idtextRequired - The taxon's AphiaID, WoRMS's number for it, e.g. 126436 for Atlantic cod. Find it with Find AphiaID by name. The taxon's page address or LSID works too.
- Language
languagetext - Only names in this language: its English name or its three-letter ISO 639-3 code. Leave empty for every language.
Outputs
aphia_idnumber- The taxon's AphiaID, WoRMS's permanent number for it.
common_nameslist- The common names.
countnumber- How many came back.
Example output
{
"aphia_id": 126436,
"common_names": [
{
"language": "English",
"language_code": "eng",
"name": "Atlantic cod"
},
{
"language": "English",
"language_code": "eng",
"name": "cod"
}
],
"count": 2
}List distributions
List where a taxon is recorded, by sea area or country, with whether each record is reliable and, for introduced species, whether it is native or alien there.
Inputs
- AphiaID
aphia_idtextRequired - The taxon's AphiaID, WoRMS's number for it, e.g. 126436 for Atlantic cod. Find it with Find AphiaID by name. The taxon's page address or LSID works too.
Outputs
aphia_idnumber- The taxon's AphiaID, WoRMS's permanent number for it.
countnumber- How many came back.
distributionslist- The places it is recorded.
Example output
{
"aphia_id": 126436,
"count": 2,
"distributions": [
{
"establishment_means": null,
"higher_geography": "North Sea",
"higher_geography_id": "http://marineregions.org/mrgid/2350",
"invasiveness": null,
"latitude": null,
"locality": "Westerschelde",
"location_id": "http://marineregions.org/mrgid/4752",
"longitude": null,
"occurrence": null,
"quality_status": "unreviewed",
"record_status": "valid",
"type_status": null
},
{
"establishment_means": null,
"higher_geography": "North Sea",
"higher_geography_id": "http://marineregions.org/mrgid/2350",
"invasiveness": null,
"latitude": null,
"locality": "Westerschelde",
"location_id": "http://marineregions.org/mrgid/4752",
"longitude": null,
"occurrence": null,
"quality_status": "unreviewed",
"record_status": "valid",
"type_status": null
}
]
}List sources
List the references WoRMS cites for a taxon, such as its original description, with page numbers, DOIs and links.
Inputs
- AphiaID
aphia_idtextRequired - The taxon's AphiaID, WoRMS's number for it, e.g. 126436 for Atlantic cod. Find it with Find AphiaID by name. The taxon's page address or LSID works too.
Outputs
aphia_idnumber- The taxon's AphiaID, WoRMS's permanent number for it.
countnumber- How many came back.
sourceslist- The references.
Example output
{
"aphia_id": 126436,
"count": 2,
"sources": [
{
"doi": null,
"fulltext_url": null,
"link": "https://www.fishbase.org",
"page": null,
"reference": "Froese, R. & D. Pauly (Editors). (2026). FishBase. World Wide Web electronic publication. version (04/2025).",
"source_id": 1128,
"url": "https://www.marinespecies.org/aphia.php?p=sourcedetails&id=1128",
"use": "additional source"
},
{
"doi": "10.1093/oso/9780198573562.001.0001",
"fulltext_url": null,
"link": null,
"page": "252",
"reference": "Hayward, P.J. & J.S. Ryland (Eds.). (1990). The marine fauna of the British Isles and North-West Europe: 1. Introduction and protozoans to arthropods. Clarendon Press: Oxford, UK. 627 pp.",
"source_id": 1,
"url": "https://www.marinespecies.org/aphia.php?p=sourcedetails&id=1",
"use": "additional source"
}
]
}List synonyms
List every other name a taxon has been known by (synonyms, old combinations and misspellings), each with why it is not used.
Inputs
- AphiaID
aphia_idtextRequired - The taxon's AphiaID, WoRMS's number for it, e.g. 126436 for Atlantic cod. Find it with Find AphiaID by name. The taxon's page address or LSID works too.
- Number of results
limitnumber - How many synonyms to return, 1 to 200. Defaults to 50. WoRMS sends 50 at a time, so more take longer.From 1 to 200.
- Skip
skipnumber - How many to skip first. To get the next ones after an earlier step, use its next_skip. Defaults to 0.From 0 to 100000.
Outputs
aphia_idnumber- The taxon's AphiaID, WoRMS's permanent number for it.
countnumber- How many came back in this step.
has_moretrue/false- True when WoRMS may have more after these.
next_skipnumber- The Skip value that gets the next ones, when there may be more.
synonymslist- The synonyms, alphabetically.
Example output
{
"aphia_id": 126436,
"count": 2,
"has_more": false,
"next_skip": null,
"synonyms": [
{
"aphia_id": 316432,
"authority": null,
"citation": "Froese, R. and D. Pauly. Editors. (2026). FishBase. Asellus major. Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=316432 on 2026-10-21",
"class": "Teleostei",
"family": "Gadidae",
"genus": "Asellus",
"is_brackish": true,
"is_extinct": null,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:316432",
"modified": "2008-02-28T13:41:07.550Z",
"order": "Gadiformes",
"original_aphia_id": null,
"parent_aphia_id": 296060,
"phylum": "Chordata",
"rank": "Species",
"rank_id": 220,
"scientific_name": "Asellus major",
"status": "unaccepted",
"unaccept_reason": null,
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=316432",
"valid_aphia_id": 126436,
"valid_authority": "Linnaeus, 1758",
"valid_name": "Gadus morhua"
},
{
"aphia_id": 300724,
"authority": "Mitchill, 1815",
"citation": "Froese, R. and D. Pauly. Editors. (2026). FishBase. Gadus arenosus Mitchill, 1815. Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=300724 on 2026-10-21",
"class": "Teleostei",
"family": "Gadidae",
"genus": "Gadus",
"is_brackish": true,
"is_extinct": null,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:300724",
"modified": "2023-01-10T08:56:01.993Z",
"order": "Gadiformes",
"original_aphia_id": 300724,
"parent_aphia_id": 125732,
"phylum": "Chordata",
"rank": "Species",
"rank_id": 220,
"scientific_name": "Gadus arenosus",
"status": "unaccepted",
"unaccept_reason": null,
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=300724",
"valid_aphia_id": 126436,
"valid_authority": "Linnaeus, 1758",
"valid_name": "Gadus morhua"
}
]
}List taxa by rank
List every taxon of one rank within a group, such as every species in a family or every genus in an order, however many ranks down.
Inputs
- Rank
ranktextRequired - The rank of the taxa to list.One of:
kingdom,subkingdom,phylum(Phylum (Division in plants and fungi)),subphylum(Subphylum (Subdivision)),superclass,class,subclass,infraclass,superorder,order, and 18 more. - Within taxon
within_aphia_idtext - The AphiaID of the group to look in, e.g. 125469 for the family Gadidae. Leave empty to list the rank across all of WoRMS, 50 at a time.
- Number of results
limitnumber - How many taxa to return, 1 to 200. Defaults to 50. WoRMS sends 50 at a time, so more take longer.From 1 to 200.
- Skip
skipnumber - How many to skip first. To get the next ones after an earlier step, use its next_skip. Defaults to 0.From 0 to 100000.
Outputs
countnumber- How many came back in this step.
has_moretrue/false- True when WoRMS may have more after these.
next_skipnumber- The Skip value that gets the next ones, when there may be more.
ranktext- The rank listed, e.g. 'Species'.
rank_idnumber- WoRMS's number for the rank.
taxalist- The taxa, in WoRMS's order.
within_aphia_idnumber- The group looked in, if one was given.
Example output
{
"count": 2,
"has_more": true,
"next_skip": 2,
"rank": "Species",
"rank_id": 220,
"taxa": [
{
"aphia_id": 126432,
"authority": "(Peters, 1872)",
"citation": "Froese, R. and D. Pauly. Editors. (2026). FishBase. Arctogadus glacialis (Peters, 1872). Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=126432 on 2026-10-21",
"class": "Teleostei",
"family": "Gadidae",
"genus": "Arctogadus",
"is_brackish": false,
"is_extinct": null,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:126432",
"modified": "2008-01-15T17:27:08.177Z",
"order": "Gadiformes",
"original_aphia_id": 300748,
"parent_aphia_id": 125728,
"phylum": "Chordata",
"rank": "Species",
"rank_id": 220,
"scientific_name": "Arctogadus glacialis",
"status": "accepted",
"unaccept_reason": null,
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=126432",
"valid_aphia_id": 126432,
"valid_authority": "(Peters, 1872)",
"valid_name": "Arctogadus glacialis"
},
{
"aphia_id": 126433,
"authority": "(Lepechin, 1774)",
"citation": "Froese, R. and D. Pauly. Editors. (2026). FishBase. Boreogadus saida (Lepechin, 1774). Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=126433 on 2026-10-21",
"class": "Teleostei",
"family": "Gadidae",
"genus": "Boreogadus",
"is_brackish": true,
"is_extinct": null,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:126433",
"modified": "2008-01-15T17:27:08.177Z",
"order": "Gadiformes",
"original_aphia_id": 154823,
"parent_aphia_id": 125729,
"phylum": "Chordata",
"rank": "Species",
"rank_id": 220,
"scientific_name": "Boreogadus saida",
"status": "accepted",
"unaccept_reason": null,
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=126433",
"valid_aphia_id": 126433,
"valid_authority": "(Lepechin, 1774)",
"valid_name": "Boreogadus saida"
}
],
"within_aphia_id": 125469
}List taxa with attribute
List the taxa that have a trait recorded, such as an IUCN Red List category or a body size, with their names and the trait's values.
Inputs
- Attribute
attribute_idtextRequired - The attribute the taxa must have.
- Number of results
limitnumber - How many taxa to return, 1 to 200. Defaults to 50. WoRMS sends 50 at a time, so more take longer.From 1 to 200.
- Skip
skipnumber - How many to skip first. To get the next ones after an earlier step, use its next_skip. Defaults to 0.From 0 to 100000.
Outputs
attribute_idnumber- The attribute definition asked about.
countnumber- How many came back in this step.
has_moretrue/false- True when WoRMS may have more after these.
next_skipnumber- The Skip value that gets the next ones, when there may be more.
taxalist- The taxa, by AphiaID.
Example output
{
"attribute_id": 1,
"count": 2,
"has_more": true,
"next_skip": 2,
"taxa": [
{
"aphia_id": 100801,
"attributes": [
{
"category_id": 13,
"details": [
{
"category_id": 1,
"level": 1,
"type": "IUCN Red List Category",
"type_id": 1,
"value": "Data Deficient"
},
{
"category_id": null,
"level": 2,
"type": "Year Assessed",
"type_id": 3,
"value": "2014"
}
],
"inherited_from_aphia_id": null,
"quality_status": "unreviewed",
"reference": "IUCN Red List of Threatened Species",
"source_id": 127093,
"summary": "Species importance to society: IUCN Red List (IUCN Red List Category: Data Deficient; Year Assessed: 2014)",
"type": "Species importance to society",
"type_id": 23,
"value": "IUCN Red List"
}
],
"authority": "Delle Chiaje, 1822",
"rank": "Species",
"scientific_name": "Actinia cari",
"status": "accepted",
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=100801"
},
{
"aphia_id": 100807,
"attributes": [
{
"category_id": 13,
"details": [
{
"category_id": 1,
"level": 1,
"type": "IUCN Red List Category",
"type_id": 1,
"value": "Data Deficient"
},
{
"category_id": null,
"level": 2,
"type": "Year Assessed",
"type_id": 3,
"value": "2014"
}
],
"inherited_from_aphia_id": null,
"quality_status": "unreviewed",
"reference": "IUCN Red List of Threatened Species",
"source_id": 127093,
"summary": "Species importance to society: IUCN Red List (IUCN Red List Category: Data Deficient; Year Assessed: 2014)",
"type": "Species importance to society",
"type_id": 23,
"value": "IUCN Red List"
}
],
"authority": "Rizzi, 1907",
"rank": "Species",
"scientific_name": "Actinia striata",
"status": "unreplaced junior homonym",
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=100807"
}
]
}List taxonomic ranks
List the taxonomic ranks WoRMS uses in each kingdom, from Kingdom down to Forma, with the number WoRMS gives each rank.
Inputs
- Kingdom
kingdomtext - Only this kingdom's ranks. Leave empty for every kingdom.One of:
animalia(Animalia (animals)),plantae(Plantae (plants)),fungi,protozoa,bacteria,chromista(Chromista (brown algae, diatoms, forams...)),archaea,viruses.
Outputs
countnumber- How many came back.
rankslist- The ranks, kingdom by kingdom.
Example output
{
"count": 3,
"ranks": [
{
"kingdom": "Animalia",
"kingdom_aphia_id": 2,
"rank": "Kingdom",
"rank_id": 10
},
{
"kingdom": "Animalia",
"kingdom_aphia_id": 2,
"rank": "Subkingdom",
"rank_id": 20
},
{
"kingdom": "Animalia",
"kingdom_aphia_id": 2,
"rank": "Phylum",
"rank_id": 30
}
]
}Match names
Match up to 50 scientific names to WoRMS with TAXAMATCH, which forgives misspellings (Gadus morua finds Gadus morhua). Each name comes back with its best match, how it matched, and the accepted name to use.
Inputs
- Names
nameslistRequired - The scientific names to match, up to 50. A list from an earlier step works, and so does text with one name per line or separated by commas.
- Marine taxa only
marine_onlytrue/false - Only include taxa that live in the sea. WoRMS also lists many freshwater and land taxa; turn this off to include them.Default:
true. - Living taxa only
extant_onlytrue/false - Leave out extinct taxa known only as fossils. Turn off to include them.Default:
true.
Outputs
countnumber- How many names were looked up.
matched_countnumber- How many of them matched.
resultslist- One result per name, in the order given.
Example output
{
"count": 2,
"matched_count": 1,
"results": [
{
"aphia_id": 126436,
"authority": "Linnaeus, 1758",
"input_name": "Gadus morua",
"match_type": "phonetic",
"matched": true,
"matches": [
{
"aphia_id": 126436,
"authority": "Linnaeus, 1758",
"citation": "Froese, R. and D. Pauly. Editors. (2026). FishBase. Gadus morhua Linnaeus, 1758. Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=126436 on 2026-10-21",
"class": "Teleostei",
"family": "Gadidae",
"genus": "Gadus",
"is_brackish": true,
"is_extinct": null,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:126436",
"match_type": "phonetic",
"modified": "2008-01-15T17:27:08.177Z",
"order": "Gadiformes",
"original_aphia_id": 126436,
"parent_aphia_id": 125732,
"phylum": "Chordata",
"rank": "Species",
"rank_id": 220,
"scientific_name": "Gadus morhua",
"status": "accepted",
"unaccept_reason": null,
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=126436",
"valid_aphia_id": 126436,
"valid_authority": "Linnaeus, 1758",
"valid_name": "Gadus morhua"
}
],
"scientific_name": "Gadus morhua",
"status": "accepted",
"valid_aphia_id": 126436,
"valid_name": "Gadus morhua"
},
{
"aphia_id": null,
"authority": null,
"input_name": "Notarealthingus zzz",
"match_type": null,
"matched": false,
"matches": [],
"scientific_name": null,
"status": null,
"valid_aphia_id": null,
"valid_name": null
}
]
}Search by common name
Find the taxa known by a common name in any language, such as killer whale or kabeljauw, with their scientific names.
Inputs
- Common name
common_nametextRequired - The common name, e.g. killer whale.
- Match
matchtext - Whether the common name must be exactly this, or only contain it.One of:
exact(Exactly),contains. Default:exact. - Number of results
limitnumber - How many taxa to return, 1 to 200. Defaults to 50. WoRMS sends 50 at a time, so more take longer.From 1 to 200.
- Skip
skipnumber - How many to skip first. To get the next ones after an earlier step, use its next_skip. Defaults to 0.From 0 to 100000.
Outputs
common_nametext- The name searched for.
countnumber- How many came back in this step.
has_moretrue/false- True when WoRMS may have more after these.
next_skipnumber- The Skip value that gets the next ones, when there may be more.
taxalist- The taxa known by that name.
Example output
{
"common_name": "killer whale",
"count": 1,
"has_more": false,
"next_skip": null,
"taxa": [
{
"aphia_id": 137102,
"authority": "(Linnaeus, 1758)",
"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-10-21",
"class": "Mammalia",
"family": "Delphinidae",
"genus": "Orcinus",
"is_brackish": null,
"is_extinct": null,
"is_freshwater": null,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:137102",
"modified": "2008-08-20T11:25:36.853Z",
"order": "Cetartiodactyla",
"original_aphia_id": 148730,
"parent_aphia_id": 137021,
"phylum": "Chordata",
"rank": "Species",
"rank_id": 220,
"scientific_name": "Orcinus orca",
"status": "accepted",
"unaccept_reason": null,
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=137102",
"valid_aphia_id": 137102,
"valid_authority": "(Linnaeus, 1758)",
"valid_name": "Orcinus orca"
}
]
}Search taxa by name
Find taxa whose scientific name starts with, or is exactly, the text given, accepted and unaccepted names alike, each with its accepted name.
Inputs
- Scientific name
nametextRequired - The name or the start of it, e.g. Gadus.
- Match
matchtext - Whether names must start with the text or be exactly it.One of:
starts_with(Starts with),exact(Exactly). Default:starts_with. - Marine taxa only
marine_onlytrue/false - Only include taxa that live in the sea. WoRMS also lists many freshwater and land taxa; turn this off to include them.Default:
true. - Living taxa only
extant_onlytrue/false - Leave out extinct taxa known only as fossils. Turn off to include them.Default:
true. - Number of results
limitnumber - How many taxa to return, 1 to 200. Defaults to 50. WoRMS sends 50 at a time, so more take longer.From 1 to 200.
- Skip
skipnumber - How many to skip first. To get the next ones after an earlier step, use its next_skip. Defaults to 0.From 0 to 100000.
Outputs
countnumber- How many came back in this step.
has_moretrue/false- True when WoRMS may have more after these.
nametext- The name searched for.
next_skipnumber- The Skip value that gets the next ones, when there may be more.
taxalist- The taxa found, in WoRMS's order.
Example output
{
"count": 2,
"has_more": true,
"name": "Gadus",
"next_skip": 2,
"taxa": [
{
"aphia_id": 125732,
"authority": "Linnaeus, 1758",
"citation": "Froese, R. and D. Pauly. Editors. (2026). FishBase. Gadus Linnaeus, 1758. Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=125732 on 2026-10-21",
"class": "Teleostei",
"family": "Gadidae",
"genus": "Gadus",
"is_brackish": true,
"is_extinct": null,
"is_freshwater": false,
"is_marine": true,
"is_terrestrial": false,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:125732",
"modified": "2014-11-21T13:09:37.943Z",
"order": "Gadiformes",
"original_aphia_id": null,
"parent_aphia_id": 125469,
"phylum": "Chordata",
"rank": "Genus",
"rank_id": 180,
"scientific_name": "Gadus",
"status": "accepted",
"unaccept_reason": null,
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=125732",
"valid_aphia_id": 125732,
"valid_authority": "Linnaeus, 1758",
"valid_name": "Gadus"
},
{
"aphia_id": 990530,
"authority": "Deshayes, 1861",
"citation": "MolluscaBase eds. (2026). MolluscaBase. Gadus Deshayes, 1861. Accessed through: World Register of Marine Species at: https://www.marinespecies.org/aphia.php?p=taxdetails&id=990530 on 2026-10-21",
"class": "Scaphopoda",
"family": "Gadilidae",
"genus": "Gadus",
"is_brackish": null,
"is_extinct": null,
"is_freshwater": null,
"is_marine": true,
"is_terrestrial": null,
"kingdom": "Animalia",
"lsid": "urn:lsid:marinespecies.org:taxname:990530",
"modified": "2017-04-24T11:36:56.677Z",
"order": "Gadilida",
"original_aphia_id": 990530,
"parent_aphia_id": 435,
"phylum": "Mollusca",
"rank": "Genus",
"rank_id": 180,
"scientific_name": "Gadus",
"status": "unaccepted",
"unaccept_reason": "invalid: junior homonym of <i>Gadus</i> Linnaeus, 1758",
"url": "https://www.marinespecies.org/aphia.php?p=taxdetails&id=990530",
"valid_aphia_id": 138026,
"valid_authority": "J. E. Gray, 1847",
"valid_name": "Gadila"
}
]
}