Fields in green are included in the results only if the input parameter detail=simple (default). If detail=full then all result fields will be included.
Field |
Description |
commonName |
species common name |
scientificName |
species scientific name |
obsDt |
observation date (e.g. Feb 27, 2009). formatted according to input locale |
howMany |
The number observed. Not included if only presence was noted |
locID |
unique identifier for the location |
locName |
location name |
lat |
latitude of the location |
lng |
longitude of the location |
subnational2Code |
county code |
subnational2Name |
county name |
subnational1Code |
state/province ISO code |
subnational1Name |
state/province name |
countryCode |
country ISO code |
countryName |
country name |
firstName |
observer's first name |
lastName |
observer's last name |
subID |
submission ID |
obsID |
observation ID |
checklistID |
checklist ID |
obsReviewed |
|
obsValid |
|
locationPersonal |
|
presenceNoted |
|
Format
General format notes.
JSON
Example JSON result for simple detail:
[{"howMany":"39","lat":42.4791969,"locID":"L97555","locName":"Sapsucker Woods","commonName":"Mallard","lng":-76.4513778,"scientificName":"Anas platyrhynchos","obsDt":"Mar 2, 2009"},{"lat":42.4791969,"locID":"L97555","locName":"Sapsucker Woods","commonName":"Mourning Dove","lng":-76.4513778,"scientificName":"Zenaida macroura","obsDt":"Mar 2, 2009"}]
Special Conditions & Error Handling
If there are validation problems with the input parameters the response will be an HTTP 400 error code that includes a simple array containing details of the problems encountered:
["Latitude out of range","Longitude out of range"]