Get the IRMNG_ID for a given name. Output: NULL when no match is found; -999 when multiple matches are found; an integer (IRMNG_ID) when one exact match was found Parameters: <ul> <li>marine_only: Limit to marine taxa</li> <li>extant_only: Limit to extant taxa</li> </ul> Returns: <ul> <li> NULL when no match is found</li> <li> -999 when multiple matches are found</li> <li> an integer (IRMNG_ID) when one exact match was found</li> </ul> Get one or more matching (max. 50) AphiaRecords for a given name Parameters: <ul> <li>like: Add a '%'-sign added after the ScientificName (SQL LIKE function). Default=true</li> <li>fuzzy: This parameter is deprecated (and ignored since '2013-07-17'). Please use the function matchAphiaRecordsByNames() for fuzzy/near matching</li> <li>marine_only: Limit to marine taxa</li> <li>offset: Starting recordnumber, when retrieving next chunk of (50) records. Default=1</li> <li>extant_only: Limit to extant taxa</li> </ul> For the structure of the returned AphiaRecords, please refer to the function getAphiaRecordByID() Get the name for a given IRMNG_ID. Get the complete AphiaRecord for a given IRMNG_ID The returned AphiaRecord has this format: <ul><li> IRMNG_ID : Unique and persistent identifier within IRMNG. Primary key in the database --</li><li> url : HTTP URL to the AphiaRecord</li><li> scientificname : The full scientific name without authorship</li><li> authority : The authorship information for the scientificname formatted according to the conventions of the applicable nomenclaturalCode</li><li> taxonRankID : The taxonomic rank identifier of the most specific name in the scientificname</li><li> rank : The taxonomic rank of the most specific name in the scientificname</li><li> status : The status of the use of the scientificname (usually a taxonomic opinion). Additional technical statuses are (1) quarantined: hidden from public interface after decision from an editor and (2) deleted: IRMNG_ID should NOT be used anymore, please replace it by the valid_IRMNG_ID</li><li> unacceptreason : The reason why a scientificname is unaccepted</li><li> valid_IRMNG_ID : The IRMNG_ID (for the scientificname) of the currently accepted taxon. NULL if there is no currently accepted taxon.</li><li> valid_name : The scientificname of the currently accepted taxon</li><li> valid_authority : The authorship information for the scientificname of the currently accepted taxon</li><li> parentNameUsageID : The IRMNG_ID (for the scientificname) of the direct, most proximate higher-rank parent taxon (in a classification)</li><li> originalNameUsageID : The IRMNG_ID (for the scientificname) of the original name</li><li> kingdom : The full scientific name of the kingdom in which the taxon is classified</li><li> phylum : The full scientific name of the phylum or division in which the taxon is classified</li><li> class : The full scientific name of the class in which the taxon is classified</li><li> order : The full scientific name of the order in which the taxon is classified</li><li> family : The full scientific name of the family in which the taxon is classified</li><li> genus : The full scientific name of the genus in which the taxon is classified</li><li> citation : A bibliographic reference for the resource as a statement indicating how this record should be cited (attributed) when used</li><li> lsid : LifeScience Identifier. Persistent GUID for an IRMNG_ID</li><li> isMarine : A boolean flag indicating whether the taxon is a marine organism, i.e. can be found in/above sea water. Possible values: 0/1/NULL</li><li> isBrackish : A boolean flag indicating whether the taxon occurs in brackish habitats. Possible values: 0/1/NULL</li><li> isFreshwater : A boolean flag indicating whether the taxon occurs in freshwater habitats, i.e. can be found in/above rivers or lakes. Possible values: 0/1/NULL</li><li> isTerrestrial : A boolean flag indicating the taxon is a terrestrial organism, i.e. occurs on land as opposed to the sea. Possible values: 0/1/NULL</li><li> isExtinct : A flag indicating an extinct organism. Possible values: 0/1/NULL</li><li> match_type : Type of match. Possible values: exact/exact_subgenus/exact_replaced/like/phonetic/near_1/near_2/near_3/match_quarantine/match_deleted. See <a href='https://www.marinespecies.org/tutorial_taxonmatch.php' target='_blank'>here</a> (bottom) for a full explanation of the types of matches.</li><li> modified : The most recent date-time in GMT on which the resource was changed</li></ul> Get an AphiaRecord for multiple IRMNG_IDs in one go (max: 50) For the structure of the returned AphiaRecords, please refer to the function getAphiaRecordByID() Get the Aphia Record for a given external identifier Parameters: <ul> <li>Type: Type of external identifier to search for. The type should be one of the following values: <ul> <li>algaebase: Algaebase species ID</li> <li>bold: Barcode of Life Database (BOLD) TaxID</li> <li>dyntaxa: Dyntaxa ID</li> <li>fishbase: FishBase species ID</li> <li>iucn: IUCN Red List Identifier</li> <li>lsid: Life Science Identifier</li> <li>ncbi: NCBI Taxonomy ID (Genbank)</li> <li>tsn: ITIS Taxonomic Serial Number</li> <li>gisd: Global Invasive Species Database</li> </ul></li> </ul> Get any external identifier(s) for a given IRMNG_ID Parameters: <ul> <li>Type: Type of external identifier to return. The type should be one of the following values: <ul> <li>algaebase: Algaebase species ID</li> <li>bold: Barcode of Life Database (BOLD) TaxID</li> <li>dyntaxa: Dyntaxa ID</li> <li>fishbase: FishBase species ID</li> <li>iucn: IUCN Red List Identifier</li> <li>lsid: Life Science Identifier</li> <li>ncbi: NCBI Taxonomy ID (Genbank)</li> <li>tsn: ITIS Taxonomic Serial Number</li> <li>gisd: Global Invasive Species Database</li> </ul></li> </ul> For each given scientific name, try to find one or more AphiaRecords. This allows you to match multiple names in one call. Limited to 500 names at once for performance reasons. Parameters: <ul> <li>like: Add a '%'-sign after the ScientificName (SQL LIKE function). Default=false</li> <li>fuzzy: This parameter is deprecated (and ignored since '2013-07-17'). Please use the function matchAphiaRecordsByNames() for fuzzy/near matching</li> <li>marine_only: Limit to marine taxa</li> <li>extant_only: Limit to extant taxa</li> </ul> For the structure of the returned AphiaRecords, please refer to the function getAphiaRecordByID() Get one or more Aphia Records (max. 50) for a given vernacular Parameters: <ul> <li>like: Add a '%'-sign before and after the input (SQL LIKE '%vernacular%' function). Default=false</li> <li>offset: Starting recordnumber, when retrieving next chunk of (50) records. Default=1</li> </ul> For the structure of the returned AphiaRecords, please refer to the function getAphiaRecordByID() Lists all AphiaRecords (taxa) that have their last edit action (modified or added) during the specified period Parameters: <ul> <li>startdate: ISO 8601 formatted start date(time). Default=today(). i.e. 2026-04-04T05:48:18+00:00</li> <li>enddate: ISO 8601 formatted end date(time). Default=today(). i.e. 2026-04-04T05:48:18+00:00</li> <li>marine_only: Limit to marine taxa</li> <li>offset: Starting recordnumber, when retrieving next chunk of (50) records. Default=1</li> <li>extant_only: Limit to extant taxa</li> </ul> For the structure of the returned AphiaRecords, please refer to the function getAphiaRecordByID() Get the complete classification for one taxon. This also includes any sub or super ranks. Get one or more sources/references including links, for one IRMNG_ID Output fields include: <ul><li> source_id : Unique identifier for the source within IRMNG</li><li> use : Usage of the source for this taxon. See <a href='https://www.irmng.org/aphia.php?p=manual#topic6' target='_blank'>here</a> for all values</li><li> reference : Full citation string</li><li> page : Page(s) where the taxon is mentioned</li><li> url : Direct link to the source record</li><li> link : External link (i.e. journal, data system, etc..)</li><li> fulltext : Full text link (PDF)</li><li> doi : Digital Object Identifier</li></ul> Get all synonyms for a given IRMNG_ID Parameters: <ul> <li>offset: Starting recordnumber, when retrieving next chunk of (50) records. Default=1</li> </ul> Get all vernaculars for a given IRMNG_ID Get the direct children (max. 50) for a given IRMNG_ID Parameters: <ul> <li>offset: Starting recordnumber, when retrieving next chunk of (50) records. Default=1</li> <li>marine_only: Limit to marine taxa</li> <li>extant_only: Limit to extant taxa</li> </ul> For each given scientific name (may include authority), try to find one or more AphiaRecords, using the TAXAMATCH fuzzy matching algorithm by Tony Rees. This allows you to (fuzzy) match multiple names in one call. Limited to 50 names at once for performance reasons Parameters: <ul> <li>marine_only: Limit to marine taxa</li> <li>extant_only: Limit to extant taxa</li> </ul> For the structure of the returned AphiaRecords, please refer to the function getAphiaRecordByID() Get all distributions for a given IRMNG_ID Output fields include: <ul><li> locality : The specific description of the place</li><li> locationID : An identifier for the locality. Using the Marine Regions Geographic IDentifier (MRGID), see <a href='https://www.marineregions.org/mrgid.php' target='_blank'>https://www.marineregions.org/mrgid.php</a></li><li> higherGeography : A geographic name less specific than the information captured in the locality term. Possible values: an IHO Sea Area or Nation, derived from the MarineRegions <a href='https://www.marineregions.org/gazetteer.php' target='_blank'>gazetteer</a></li><li> higherGeographyID : An identifier for the geographic region within which the locality occurred, using MRGID</li><li> recordStatus : The status of the distribution record. Possible values are 'valid' ,'doubtful' or 'inaccurate'. See <a href='https://www.irmng.org/aphia.php?p=manual#topic8b' target=_blank>here</a> for explanation of the statuses</li><li> typeStatus : The type status of the distribution. Possible values: 'holotype' or empty.</li><li> establishmentMeans : The process by which the biological individual(s) represented in the Occurrence became established at the location. Possible values: values listed as Origin <a href='https://www.marinespecies.org/introduced/terminology.php#:~:text=Origin,Origin%20unknown' target=_blank>in WRiMS</a></li><li> decimalLatitude : The geographic latitude (in decimal degrees, WGS84)</li><li> decimalLongitude : The geographic longitude (in decimal degrees, WGS84)</li><li> qualityStatus : Quality status of the record. Possible values: 'checked', 'trusted' or 'unreviewed'. See <a href='https://www.irmng.org/aphia.php?p=manual#topic22' target='_blank'>here</a></li></ul> Get taxonomic ranks by their identifier Output fields include: <ul><li> taxonRankID : A taxonomic rank identifier</li><li> taxonRank : A taxonomic rank name</li><li> IRMNG_ID : The IRMNG_ID of the kingdom</li><li> kingdom : The name of a taxonomic kingdom the rank is used in</li></ul> Get taxonomic ranks by their name Output fields include: <ul><li> taxonRankID : A taxonomic rank identifier</li><li> taxonRank : A taxonomic rank name</li><li> IRMNG_ID : The IRMNG_ID of the kingdom</li><li> kingdom : The name of a taxonomic kingdom the rank is used in</li></ul> Get the AphiaRecords for a given taxonRankID (max 50) Output fields include: For the structure of the returned AphiaRecords, please refer to the function getAphiaRecordByID() The data is licensed under a Creative Commons 'BY' 4.0 License, see http://creativecommons.org/licenses/by/4.0/deed.en. For more information, please visit https://www.irmng.org/aphia.php?p=webservice.