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&version=1.049&locale=en_US
Parameter Descriptions
Parameter Name |
Required |
Default |
Value Options |
Example Value |
Description |
---|---|---|---|---|---|
cat |
no |
species |
species |
species |
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 |
|
version |
no |
1.049 |
1.049 |
1.049 |
the taxonomic authority version number |
Resources
The current eBird taxonomy can be downloaded here. The following table might be helpful for encoding a scientific name within a URL:
Character |
Encoding |
||
---|---|---|---|
Space |
%20 |
||
<ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="340de8d7-8bba-4d09-bcbd-4beb651ba7e5"><ac:plain-text-body><![CDATA[ |
Left Square Bracket ("[") |
%5B |
]]></ac:plain-text-body></ac:structured-macro> |
Right Square Bracket ("]") |
%5D |
||
Forward slash/Virgule ("/") |
%2F |
Result Field Descriptions
XML Example: http://ebird.org/ws1.1/ref/taxa/ebird?fmt=xml
CSV Example: http://ebird.org/ws1.1/ref/taxa/ebird
Field (XML) |
Description |
---|---|
sci-name |
Scientific name |
com-name |
Common name |