Page History

{toc}

h2. Description

Returns a list of all bird species observed in a given list of hotspots along with their most recent sighting and location.the most recent sighting date and specific location for the requested species of bird reported within the number of days specified by the "back" parameter and reported in a given list of hotspots

 This is part of the [eBird version 1.1 API|eBird API 1.1].

h2. URL

*Base URL*

[http://ebird.org/ws1.1/data/obs/hotspot_spp/recent]

*Examples*

Minimal:

[http://ebird.org/ws1.1/data/obs/hotspot_spp/recent?r=L99381&sci=larus%20delawarensis]

Fully specified:

[http://ebird.org/ws1.1/data/obs/hotspot_spp/recent?r=L99381&r=L104031&sci=larus%20delawarensis&back=5&maxResults=500&detail=simple&locale=en_US&fmt=json&includeProvisional=true]

h2. Parameter Descriptions

|| Parameter Name || Required || Default \\ || Value Options \\ || Example Value \\ || Description ||
| back \\ | | 14 \\ | 1 - 30 integer | 7 | the number of days back to look for observations \\ |
| maxResults | | \\ | 1 - 10000 integer \\ | 10 \\ | the maximum number of result rows to return in this request; to get all results do not include this parameter \\ |
| detail \\ | | simple \\ | simple, full\\ | simple \\ | toggle to restrict results to either all or a subset of sighting fields.  see [result field descriptions|eBird API 1.1-FullResultsDescription]  \\ |
| locale \\ | | en_US | Java standard locale codes | fr_CA \\ | Language/locale of response (when translations are available). See [http://java.sun.com/javase/6/docs/api/java/util/Locale.html]. \\ |
| fmt \\ | | xml\\ | json, xml \\ | json \\ | format of the response \\ |
| r | yes | | any hotspot locID | L99381 \\ | Code(s) for region of interest; here, regions are the locIDs of hotspots.  LocIDs that are not valid or are not hotspots are ignored. Maximum of 10 locIDs. |
| includeProvisional \\ | | false \\ | true,false \\ | false \\ | set to true if you'd like flagged records that have not yet been reviewed to be included in the results\\ |
| sci \\ | yes \\ | | any scientific name \\ | larus%20delawarensis \\ | scientific name of the species of interest  (not case sensitive).  See [eBird-1.1-SpeciesReference] for a complete list of supported scientific names |

{include:eBird API 1.1-FullResultsDescription}


{import:eBird-footer}