eBird-1.1-SpeciesReference

Description

Returns a list of all species in the eBird taxonomy for the given combination of categories. The default category is "species". Any taxon with the category of 'species' may be used as a parameter in service calls that take a scientific name. Any taxon not in this category will be rejected by these services at this time.

This is part of the eBird version 1.1 API.

URL

Base URL

http://ebird.org/ws1.1/ref/taxa

Examples

Minimal:

http://ebird.org/ws1.1/ref/taxa/ebird

Fully specified:

http://ebird.org/ws1.1/ref/taxa/ebird?cat=species&fmt=xml&locale=en_US

Parameter Descriptions

Parameter Name	Required	Default	Value Options	Example Value	Description
cat	no	species	domestic,form,hybrid,intergrade,issf,slash,species,spuh (can be comma-separated for multiple categories)	hybrid	For more info about the meaning of species categories, see http://ebird.org/content/ebird/about/ebird-taxonomy
locale	no	en_US	de,en_AE,en_AU,en_IN,en_NZ,en_UK,en_ZA,es,es_AR,es_CL,es_CU,es_DO,es_ES,es_MX,es_PA,es_PR,fi,fr,fr_HT,ht_HT,in,is,pt_BR,pt_PT,tr,zh	fr_CA	The locale for the taxon common name
fmt	no	csv	xml,json,csv	xml

Resources

The human readable version of the current eBird taxonomy can also be downloaded here.

Result Fields

Field (XML)	Description
sci-name	Scientific name
com-name	Common name
taxon-id	Taxonomic Concept identifier, note this is currently in test
category	The taxonomic category (species, slash, etc.)
taxon-order	A float representing the taxonomic order
species-code	An internal code for the taxon

Example Responses

CSV

SCIENTIFIC_NAME,COMMON_NAME,TAXON_ID,SPECIES_CODE,CATEGORY,TAXON_ORDER
Struthio camelus,Ostrich,TC000001,ostric1,species,1.0
Rhea americana,Greater Rhea,TC000004,grerhe1,species,7.0

<response>
    <header>
        <locale country="" language="en"/>
        <timestamp>
            2009-07-08T10:39:42.150-04:00
        </timestamp>
        <criteria>
            <locale country="" language="en"/>
            <cat>
                species
            </cat>
            <fmt>
                xml
            </fmt>
        </criteria>
    </header>
    <result>
    <taxa>
        <com-name>
            Greater Rhea
        </com-name>
        <sci-name>
            Rhea americana
        </sci-name>
        <taxon-id>
            TC00000004
        </taxon-id>
    </taxa>
    <taxa>
        <com-name>
            Lesser Rhea
        </com-name>
        <sci-name>
            Rhea pennata
        </sci-name>
        <taxon-id>
            TC00000005
        </taxon-id>
    </taxa>
</response>

XML

Caching Information

For details on caching of results by our servers, see eBird-1.1-CacheInformation

Unknown macro: {import}

Page tree