Integrated Taxonomic Information System - TSN Search APIs

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