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
http://ebird.org/ws1.1/ref/taxa/ebird?cat=species,hybrid&fmt=json&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 | These can be comma-separated to include multiple categories in the results. For more info about the meaning of species categories, see http://ebird.org/content/ebird/about/ebird-taxonomy. |
locale | no | en_US | en,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
XML
<response> <header> <locale country="" language="en"/> <timestamp>2015-02-27T11:40:13.819-05:00</timestamp> <criteria find-command-flag="false"> <fmt>xml</fmt> <dataset>eBird</dataset> <version>1.55</version> <cat>species</cat> <locale country="" language="en"/> </criteria> </header> <result> <taxa> <taxon-id>TC000001</taxon-id> <com-name>Ostrich</com-name> <species-code>ostric1</species-code> <category>species</category> <taxon-order>1.0</taxon-order> <sci-name>Struthio camelus</sci-name> </taxa> </result> </response>
XML
Caching Information
For details on caching of results by our servers, see eBird-1.1-CacheInformation
Unknown macro: {import}