spacing image spacing image spacing image spacing image
ITIS Logo ITIS Web Service Logo spacing image
spacing image Web Service Taxonomic Serial Number (TSN) Search APIs

 Get Accepted Names from TSN
Description
Returns a list of accepted names for the TSN. This can return more than one result if the TSN is for a synonym.
Input
A string containing the ITIS TSN.
Output
A list of one or more accepted names, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getAcceptedNamesFromTSN?tsn=183671 (tsn not accepted)
http://www.itis.gov/ITISWebService/services/ITISService/getAcceptedNamesFromTSN?tsn=526853 (tsn accepted)

 Get Comment Detail from TSN
Description
Returns the list of comments for the TSN. This can return more than result if multiple comments are entered.
Input
A string containing the ITIS TSN.
Output
A list of one or more comments, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getCommentDetailFromTSN?tsn=180543

 Get Common Names from TSN
Description
Returns a list of common names for the TSN.
Input
A string containing the ITIS TSN.
Output
A list of one or more common names, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getCommonNamesFromTSN?tsn=531894 (no common name)
http://www.itis.gov/ITISWebService/services/ITISService/getCommonNamesFromTSN?tsn=183833 (multiple names)
http://www.itis.gov/ITISWebService/services/ITISService/getCommonNamesFromTSN?tsn=173441 (multiple names/languages)
http://www.itis.gov/ITISWebService/services/ITISService/getCommonNamesFromTSN?tsn=27826 (one name)

 Get Core Metadata from TSN
Description
Returns the set of core metadata for the TSN. This contains credibility rating, taxonomic usage, unacceptability reason, coverage, and currency data
Input
A string containing the ITIS TSN.
Output
A set of strings containing the credibility rating, taxonomic usage, unacceptability reason, coverage, and currency data, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getCoreMetadataFromTSN?tsn=28727 (coverage and currrency data)
http://www.itis.gov/ITISWebService/services/ITISService/getCoreMetadataFromTSN?tsn=183671 (no coverage or currency data)

 Get Coverage from TSN
Description
Returns the taxon coverage information for the TSN. This information is  available for Genus and above (rank_id > 190) only.
Input
A string containing the ITIS TSN.
Output
A string containing the coverage data, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getCoverageFromTSN?tsn=28727 (coverage data)
http://www.itis.gov/ITISWebService/services/ITISService/getCoverageFromTSN?tsn=526852 (no coverage data)

 Get Credibility Rating from TSN
Description
Returns the credibility rating for the TSN.
Input
A string containing the ITIS TSN.
Output
A string containing the credibility rating, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getCredibilityRatingFromTSN?tsn=526852

 Get Currency from TSN
Description
Returns the taxon currency information for the TSN. This information is  available for Genus and above (rank_id > 190) only.
Input
A string containing the ITIS TSN.
Output
A string containing the currency rating, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getCurrencyFromTSN?tsn=28727 (currency data)
http://www.itis.gov/ITISWebService/services/ITISService/getCurrencyFromTSN?tsn=526852 (no currency data)
 Get Date Data from TSN
Description
Returns the initial time stamp and last update date for the TSN.
Input
A string containing the ITIS TSN.
Output
A set of strings containing the dates for the TSN, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getDateDataFromTSN?tsn=180543

 Get Experts from TSN
Description
Returns a list of the expert information for the TSN.
Input
A string containing the ITIS TSN.
Output
A list of one or more experts, containing the expert, comments, and reference information, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getExpertsFromTSN?tsn=180544

 Get Full Record From TSN
Description
Returns the full ITIS record for a TSN found by comparing the search key to the TSN field, or an empty result set if there is no match.

Note: Because this API must do multiple database lookups, this can be a time-comsuming operation and may take several seconds to return information.
Input
A string containing the ITIS TSN.Provides a list of all the unique origin values contained in the databaseProvides a list of all the unique origin values contained in the database
Output
A set of strings representing the full ITIS record (all ITIS data for the TSN), or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getFullRecordFromTSN?tsn=183833

 Get Geographic Divisions from TSN
Description
Returns a list of the geographic divisions for the TSN.
Input
A string containing the ITIS TSN.
Output
A list of geographic divisions, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getGeographicDivisionsFromTSN?tsn=180543

 Get Global Species Completeness from TSN
Description
Retruns the taxon completenes rating for the TSN.
Input
A string containing the ITIS TSN.
Output
A string containing the completeness rating, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getGlobalSpeciesCompletenessFromTSN?tsn= 180541

 Get Jurisdictional Origin from TSN
Description
Rerurns a list of the jurisdiction and origin values for the TSN.
Input
A string containing the ITIS TSN.
Output
A set of strings containing the jurisdiction and origin, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getJurisdictionalOriginFromTSN?tsn=180543

 Get Kingdom Name from TSN
Description
Returns the kingdom name for the TSN.
Input
A string containing the ITIS TSN.
Output
A string containing the kingdom name, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getKingdomNameFromTSN?tsn=202385

 Get Other Sources from TSN
Description
Returns a list of the other sources used for the TSN.
Input
A string containing the ITIS TSN.
Output
A list of one or more other sources, containing the source, acquisition date, comment, language, etc., or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getOtherSourcesFromTSN?tsn=182662

 Get Parent TSN from TSN
Description
Returns the parent TSN for the entered TSN.
Input
A string containing the ITIS TSN.
Output
A string containing the parent tsn, or an empty set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getParentTSNFromTSN?tsn=202385

 Get Publications from TSN
Description
Returns a list of the pulications used for the TSN.
Input
A string containing the ITIS TSN.
Output
A list of one or more publications, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getPublicationsFromTSN?tsn=70340

 Get Review Year from TSN
Description
Returns the review year for the TSN.
Input
A string containing the ITIS TSN.
Output
A string containing the review year, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getReviewYearFromTSN?tsn=180541

 Get Scientific Name from TSN
Description
Returns the scientific name for the TSN. Also returns the component parts (names and indicators) of the scientific name.
Input
A string containing the ITIS TSN.
Output
A set of strings containg the full scientific name and the individual name parts and indicators, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getScientificNameFromTSN?tsn=531894

 Get Synonym Name from TSN
Description
Returns a list of the synonyms (if any) for the TSN.
Input
A string containing the ITIS TSN.
Output
A list of one or more synonyms, or an empty result set if there is no match or the TSN is unaccepted.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getSynonymNamesFromTSN?tsn=183671 (tsn not accepted)
http://www.itis.gov/ITISWebService/services/ITISService/getSynonymNamesFromTSN?tsn=526852 (tsn accepted)

 Get Taxon Authorship from TSN
Description
Returns the author information for the TSN.
Input
A string containing the ITIS TSN.
Output
A string containg the taxon author information, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getTaxonAuthorshipFromTSN?tsn=183671

 Get Taxonomic Rank Name from TSN
Description
Returns the kingdom and rank information for the TSN.
Input
A string containing the ITIS TSN.
Output
A string containing the kingdom and rank for the taxon, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getTaxonomicRankNameFromTSN?tsn= 202385

 Get Taxonomic Usage from TSN
Description
Returns the usage information for the TSN.
Input
A string containing the ITIS TSN.
Output
A string containing the usage information for the taxon, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getTaxonomicUsageFromTSN?tsn=526852

 Get Unacceptability Reason from TSN
Description
Returns the unacceptability reason, if any, for the TSN.
Input
A string containing the ITIS TSN.
Output
A string containing the unacceptability information for the taxon, or an empty result set if there is no match.
Example
http://www.itis.gov/ITISWebService/services/ITISService/getUnacceptabilityReasonFromTSN?tsn= 183671
spacing image spacing image spacing image spacing image
A gray bar