Page History

{toc}

h2. Description

Returns a list of orders, families and species which are covered by Neotropical Birds Online as well as the status of each species account in Neotropical Birds.  These are ordered base on the Clements world taxonomy

 This is part of the [Neotropical Birds version 1.0 API|NeotropicalBirds-1.0].

h2. URL

*Base URL*

[http://neotropical.birds.cornell.edu/ws1.0/ref/taxa]

h2.


h2. Result Fields

|| *Field (XML)* ||  *Attribute* || *Description* ||
| taxon-list |  | Parent tag |
| taxon-list | template-url | Partial URL for to be combined with the species id to construct a link to a Neotropical Birds species account |
| taxon-list | locale | Parent taglocale of the response, Current support for en_US only\\ |
| order com-name| | Common nameTaxonomic rank of Order |
| order | sci-name  | Scientific name of the Order |
| com-nameorder | Commonhas-complete name |

h3. Example Responses


h4. CSV

{noformat}
Rhea americana,Greater Rhea
Rhea pennata,Lesser Rhea
{noformat}

h4. XML

{noformat}
<response>
    <header>
        <locale country="" language="en"/>
        <timestamp>
            2009-07-08T10:39:42.150-04:00
        </timestamp>
        <criteria>
            <locale country="" language="en"/>
            <cat>
                species
            </cat>
            <version>
                1.049
            </version>
            <fmt>
                xml
            </fmt>
        </criteria>
    </header>
    <result>
    <taxa>
        <com-name> 0/1 boolean flag designating whether this Order contains complete species accounts |
| order | has-stub| 0/1 boolean flag designating whether this Order contains stub or partial species accounts |
| family| | Taxonomic rank of Family|
| family| sci-name  | Scientific name of the Family|
| family| has-complete | 0/1 boolean flag designating whether this Familycontains complete species accounts |
| family| has-stub| 0/1 boolean flag designating whether this Familycontains stub or partial species accounts |
| species | | Taxonomic rank of Species|
| species | com-name | Common name of this species in the locale from the taxon-list tag |
| species | sci-name | Scientific name |
| species | article-complete | Common name |
| species | article-stub| Common name |
| species | id | species "id" concatenated to the end of the template-url to generate the species account link |

h3. Example Responses


h4. XML

{noformat}
<taxon-list template-url="http://neotropical.birds.cornell.edu/portal/species/overview?p_p_spp=" locale="en_US">
   <order sci-name="Struthioniformes" has-complete="0" has-stub="0">
      <family sci-name="Rheidae" has-complete="0" has-stub="0">
         <species com-name="Greater Rhea" sci-name="Rhea americana" article-complete="0" article-stub="0" id="55956"/>
         <species com-name="Lesser Rhea" sci-name="Rhea pennata" article-complete="0" article-stub="0" id="56116"/>
      </family>
   </order>
   <order sci-name="Tinamiformes" has-complete="0" has-stub="0">
      <family sci-name="Tinamidae" has-complete="0" has-stub="0">
            Greater Rhea
        </com-name>
        <sci-name><species com-name="Tawny-breasted Tinamou" sci-name="Nothocercus julius" article-complete="0" article-stub="0" id="56276"/>
         <species   Rhea americana
        </sci-name>
    </taxa>com-name="Highland Tinamou" sci-name="Nothocercus bonapartei" article-complete="0" article-stub="0" id="56436"/>
    <taxa>
     <species com-name="Hooded Tinamou" <com-name>
    sci-name="Nothocercus nigrocapillus" article-complete="0" article-stub="0" id="56596"/>
        Lesser Rhea
      .
  </com-name>
        <sci-name>.
            Rhea pennata
  .
      </sci-name>family>
    </taxa>order>
</response>taxon-list>
{noformat}

h2. Caching Information

For details on cachingg of results by our servers, see [eBird-1.1-CacheInformation]
{import:eBird-footer}