You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 31 Next »

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

hybrid

For more info about the meaning of species categories, see http://ebird.org/content/ebird/about/ebird-taxonomy

locale

no

en_US

fr_CA,es_MX,es_PR,ht_HT,fr,fr_HT,es_CU,es_PA,es_DO,en_NZ,es,es_CL

fr_CA

The locale for the taxon common name

fmt

no

csv

xml,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

Example Responses

CSV

Rhea americana,Greater Rhea,TC000004
Rhea pennata,Lesser Rhea, TC000005

XML

<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>

Caching Information

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

Unknown macro: {import}
  • No labels