Home?
About NatureServe Web Services
Literature
News Archive
Browse Web Services
Name Search
Get Species Data
Get Ecological Systems
Get Species Location Data
Species Presence Indicator
Technical Resources
Code Samples
Species Schemas
Species Occurrence Schemas
Technical Library
Provide Feedback
Taxonomic Reconciliation
User Registration
Security Administration
Submit User Stories
Contact Us
For NatureServe Data Providers
EO Service
Support Resources
Home
For Data Providers
Technical Resources
National Species Summary by Name (public)
Description: This is a service that returns summary information about species found using a name search for a particular nation. The search will return zero, one, or many results. The typical reason for running this search is to obtain summary information for species, particularly when the summary XML output is sufficient for a specific purpose. This service allows consumers to avoid making two calls: one to get the brief list with UIDs, a second call to retrieve the species by uid one at a time.
This XML payload is more comprehensive than the Species Search XML in that it includes the Global Species Concept information as well as more conservation status and distribution information.
Service Restrictions: This is a standard service that can be installed at any node, and may return species and UID values for species that are not available via NatureServe Explorer.
Request URL: {baseURL}/idd/rest/v1/nationalSpecies/summary/nameSearch?
Request Parameters:
Parameter
Value
Description
name
string (required)
The search string. May use asterisks for wildcard searching. Unlike "google" search, mutliple terms must be in the correct order. E.g., "frog*yellow" will not find "the yellow frog", but "the*frog" will find "the yellow frog".
nationCode
string (required)
The two-letter ISO nation abbreviation (e.g., "US" or "CA").
Response Fields:
The schema document for this service response is located at http://services.natureserve.org/docs/schemas/biodiversityDataFlow/1/0/SummarySpeciesSchema_v1.0.xsd .
See the User Friendly Documents for field details: http://services.natureserve.org/docs/schemas/biodiversityDataFlow/1/0/documentation_summarySpecies_v1.0.xml
Sample Response:
URL:
https://services.natureserve.org/idd/rest/v1/nationalSpecies/summary/nameSearch?nationCode=CA&name=Colin*des*montagnes
XML Payload:
<?xml version="1.0" encoding="iso-8859-1"?>
<speciesList xsi:schemaLocation="http://services.natureserve.org/docs/schemas/biodiversityDataFlow/1 BiodiversityDataFlow_v1.0.xsd" xmlns="http://services.natureserve.org/docs/schemas/biodiversityDataFlow/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" schemaVersion="1.0">
<species uid="ELEMENT_NATIONAL.2.162045" type="Animal">
<jurisdictionNationName code="CA">CANADA</jurisdictionNationName>
<otherIdentifiers>
<otherIdentifier typeName="Canada General Status">
<identifierLeadOrganization>Canada General Status</identifierLeadOrganization>
<identifierValue>416</identifierValue>
</otherIdentifier>
</otherIdentifiers>
<nationalScientificName>
<unformattedName>Oreortyx pictus</unformattedName>
<formattedName><i>Oreortyx pictus</i></formattedName>
<nomenclaturalAuthor>(Douglas, 1829)</nomenclaturalAuthor>
</nationalScientificName>
<nationalConservationStatus lastChangedDate="2001-01-12" lastReviewedDate="2001-01-12">NNA</nationalConservationStatus>
<roundedNationalConservationStatus>NNA</roundedNationalConservationStatus>
<nationalCommonName>Mountain Quail</nationalCommonName>
<otherNationalCommonNames>
<commonName language="fr">Colin des montagnes</commonName>
</otherNationalCommonNames>
<natureServeGlobalConcept uid="ELEMENT_GLOBAL.2.104712">
<classificationStatus>Standard</classificationStatus>
<natureServeExplorerURI>
http://www.natureserve.org/explorer/servlet/NatureServe?searchSpeciesUid=ELEMENT_GLOBAL.2.104712
</natureServeExplorerURI>
<taxonomicConceptReference code="B98AOU01NAUS">
<formattedCitation>American Ornithologists' Union (AOU). 1998. Check-list of North American birds. Seventh edition. American Ornithologists' Union, Washington, DC. 829 pp.</formattedCitation>
<unformattedCitation>American Ornithologists' Union (AOU). 1998. Check-list of North American birds. Seventh edition. American Ornithologists' Union, Washington, DC. 829 pp.</unformattedCitation>
</taxonomicConceptReference>
<nameUsedInConceptReference>
<unformattedName>Oreortyx pictus</unformattedName>
<formattedName><i>Oreortyx pictus</i></formattedName>
<nomenclaturalAuthor>American Ornithologists' Union (AOU)</nomenclaturalAuthor>
</nameUsedInConceptReference>
<globalScientificName>
<unformattedName>Oreortyx pictus</unformattedName>
<formattedName><i>Oreortyx pictus</i></formattedName>
<nomenclaturalAuthor>(Douglas, 1829)</nomenclaturalAuthor>
</globalScientificName>
<globalConservationStatus>G5</globalConservationStatus>
<roundedGlobalConservationStatus>G5</roundedGlobalConservationStatus>
<globalTaxonomyComments>Formerly in family Phasianidae; placed in family Odontophoridae by AOU (1997).</globalTaxonomyComments>
</natureServeGlobalConcept>
<nationalDistributions>
<nationalDistribution>
<origin>Exotic</origin>
<regularity>Regularly occurring</regularity>
<currentPresenceAbsence>Present</currentPresenceAbsence>
<distributionConfidence>Confident</distributionConfidence>
<population>Year-round</population>
</nationalDistribution>
</nationalDistributions>
<otherStatuses>
<status name="Canada General Status">
<statusValue>Not assessed</statusValue>
<statusDate>2000-12-31</statusDate>
</status>
<status name="Exotic">
<statusValue>NE1</statusValue>
<statusDate>2001-01-12</statusDate>
</status>
</otherStatuses>
<metadata>
<references>
</references>
</metadata>
</species>
</speciesList>