spacing image spacing image spacing image spacing image
The ITIS Logo The banner for the ITIS Web Service page spacing image
spacing image spacing image
Graduated Blue Bar spacing image

Web Service Hierarchy APIs
spacing image
 Get Full Hierarchy From TSN
Description
Returns the Taxonomic Hierarchy (i.e. the hierarchy from the kingdom to the requested scientific name) found by iteratively comparing the TSN to the Parent TSN field.
Input
A string containing the ITIS TSN.
Output
The resulting hierarchy as a list of string sets containing the TSN, taxonomic rank and scientific name, or an empty result set if there is no TSN match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getFullHierarchyFromTSN?tsn=1378
spacing image
 Get Hierarchy Down From TSN
Description
Returns a list of all the valid/accepted scientific names contained within a particular valid/accepted scientific name and their TSNs, limited to immediate children only. The result set will be found by comparing the search key to the parent TSN field.

Note: There is the possibility that this could return a sizable set of data. For example, if searching with the TSN for Animalia (TSN 202423), the returned group would be all records in the Animalia tree. Because of this, this function will only return the immediate children of the search key (i.e. searching for Animalia's TSN would return the phyla directly linked to it, and the names of any other rank directly linked to it).
Input
A string containing the ITIS TSN.
Output
A set of strings containing the TSNs and the corresponding scientific names, or an empty result set if there is no TSN match or the scientific name is at the bottom of the hierarchy.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getHierarchyDownFromTSN?tsn=202420
spacing image
 Get Hierarchy Up From TSN
Description
Returns the parent of the TSN (i.e. the parent of the current scientific name in the taxonomic hierarchy) found by comparing the search key to the ITIS TSN field.
Input
A string containing the ITIS TSN.
Output
A string containing the resulting TSN, or an empty result set if there is no TSN match or the scientific name is at the top of the hierarchy.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getHierarchyUpFromTSN?tsn=1378
spacing image
spacing image
spacing image spacing image Link to the ITIS What's New Page Link to more information about the ITIS Project Query the ITIS database; produce reports Information about submitting data to ITIS Link to a menu of ITIS-related tools Bee Checklist NBII Links Link to ITIS Web Services Send Your Comments Return to the ITIS Home Page