spacing image spacing image spacing image spacing image
ITIS Logo ITIS Web Service Logo spacing image
spacing image Web Service Hierarchy APIs

 Get Full Hierarchy From TSN
Description
Returns the Taxonomic Hierarchy from the kingdom to the requested scientific name, and the immediate children of the scientific name.
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=558090

 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

 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 spacing image
A gray bar