latestOpenAPI 3.0.02026-08-10135177718.4 KB

f739db716aaf

Observations

Search observations

get/observations

Query parameters

acc'true' | 'false'

Filter by whether positional_accuracy is set or not

captive'true' | 'false'

Filter by captive / cultivated status

endemic'true' | 'false'

Filter by whether the observation is in a place with a check list entry indicating the establishment means is endemic

geo'true' | 'false'

Filter by observations that are georeferenced

id_please'true' | 'false'
identified'true' | 'false'

Filter by observations that have community identifications

introduced'true' | 'false'

Filter by observations of taxa that are introduced in their location

mappable'true' | 'false'

Filter by observations that show on map tiles

native'true' | 'false'

Filter by observations of taxa that are native to their location

out_of_range'true' | 'false'

Filter by observations of taxa that outside their known ranges

pcid'true' | 'false'
photos'true' | 'false'

Filter by observations with photos

popular'true' | 'false'

Filter by observations that have been favorited by at least one user

sounds'true' | 'false'

Filter by observations with sounds

taxon_is_active'true' | 'false'

Filter by observations of active taxa

threatened'true' | 'false'

Filter by whether the observed taxon has a conservation status of "threatened" or worse

verifiable'true' | 'false'

Filter by whether observations are 'verifiable' (i.e. have quality grades research or needs_id)

Include observations with this ID

not_idstring[]

Exclude observations with this ID

licensestring[]

Include observations with this license

photo_licensestring[]

Include observations with least one photo with this license

licensed'true' | 'false'

Include observations where the license attribute is not null, i.e. it is licensed

photo_licensed'true' | 'false'

Include observations with at least one photo with a license attribute that is not null

Include observations observed within the place with this ID

Include observations added to the project with this ID or slug

coords_viewable_for_proj'true' | 'false'

Filter by observers who trust the project(s) specified in project_id OR trust the authenticated viewer

rankstring[]

Include observations of taxa with this rank

site_idinteger[]

Include observations affiliated with the iNaturalist network website with this ID

sound_licensestring[]

Include observations that have at least one sound with this license

taxon_idinteger[]

Include observations of this taxon and its descendants

without_taxon_idinteger[]

Exclude observations of this taxon and its descendants

taxon_namestring

Include observations of taxa that have a scientific or common name matching this string

user_idstring[]

Include observations observed by users that have this ID or login

user_loginstring[]

Include observations observed by users that have this login

hourinteger[]

Include observations observed within this hour of the day

dayinteger[]

Include observations observed within this day of the month

monthinteger[]

Include observations observed within this month

yearinteger[]

Include observations observed within this year

created_dayinteger[]

Include observations created within this day of the month

created_monthinteger[]

Include observations created within this month

created_yearinteger[]

Include observations created within this year

term_idinteger[]

Include observations with annotations using this controlled term ID

term_value_idinteger[]

Include observations with annotations using this controlled value ID. Must be combined with the term_id parameter

without_term_value_idinteger[]

Exclude observations with annotations using this controlled value ID. Must be combined with the term_id parameter

term_id_or_unknowninteger[]

Include observations with annotations using this controlled term ID and associated term value IDs, or be missing annotations using this controlled term ID. Must be combined with the term_value_id or without_term_value_id parameters

annotation_user_idstring[]

Include observations with an annotation created by this user

acc_aboveinteger

Include observations with a positional accuracy above this value (meters)

acc_belowinteger

Include observations with a positional accuracy below this value (meters)

acc_below_or_unknowninteger

Include observations with a positional accuracy below this value (in meters) or with an unknown positional accuracy

d1string

Include observations observed on or after this date/time

d2string

Include observations observed on or before this date/time

created_d1string

Include observations created on or after this date/time

created_d2string

Include observations created on or before this date/time

created_onstring

Include observations created on this date

observed_onstring

Include observations observed on this date

unobserved_by_user_idstring

Exclude observations of taxa previously observed by this user

apply_project_rules_forstring

Include observations that match the rules of the project with this ID or slug

observation_accuracy_experiment_idinteger[]

Include observations included in this observation accuracy experiment

csstring

Include observations of taxa that have this conservation status code. If the place_id parameter is also specified, this will only consider statuses specific to that place

csastring

Include observations of taxa that have a conservation status from this authority. If the place_id parameter is also specified, this will only consider statuses specific to that place

csistring[]

Include observations of taxa that have this IUCN conservation status. If the place_id parameter is also specified, this will only consider statuses specific to that place

geoprivacystring[]

Include observations with this geoprivacy setting

taxon_geoprivacystring[]

Include observations where this is the most conservative geoprivacy applied by a conservation status associated with one of the taxa proposed in the current identifications

obscurationstring[]

Include observations where geoprivacy or taxon_geoprivacy match these values

hrankstring[]

Include observations of taxa with this rank or lower

lrankstring[]

Include observations of taxa with this rank or higher

iconic_taxastring[]

Include observations of taxa within this iconic taxon

id_aboveinteger

Include observations with an ID above this value

id_belowinteger

Include observations with an ID below this value

identifications'most_agree' | 'most_disagree' | 'some_agree'

Include observations based on level of agreement among identifications:

  • most_agree: includes observations where there are more active identifications of taxa that agree with the Observation Taxon than active identifications that disagree with the Observation Taxon
  • some_agree: includes observations where there are some active identifications of taxa that agree with the Observation Taxon
  • most_disagree: includes observations where there are more active identifications of taxa that disagree with the Observation Taxon than active identifications that agree with the Observation Taxon
disagreements'true' | 'false'

Include observations where there is disagreement among active identifications

latnumber float

Include observations within a {radius} kilometer circle around the specified lat/lng parameters

lngnumber float

Include observations within a {radius} kilometer circle around the specified lat/lng parameters

radiusnumber float

Include observations within a {radius} kilometer circle around the specified lat/lng parameters

nelatnumber float

Include observations within a bounding box specified by the nelat, nelng, swlat, and swlng parameters

nelngnumber float

Include observations within a bounding box specified by the nelat, nelng, swlat, and swlng parameters

swlatnumber float

Include observations within a bounding box specified by the nelat, nelng, swlat, and swlng parameters

swlngnumber float

Include observations within a bounding box specified by the nelat, nelng, swlat, and swlng parameters

list_idinteger

Include observations of taxa in a list with this ID

not_in_projectstring[]

Exclude observations added to the project this ID or slug

not_matching_project_rules_forstring

Exclude observations that match the rules of the project with this ID or slug

qstring

Include observations with a description, tags, or place_guess matching this query. Can be combined with search_on

search_on'names' | 'tags' | 'description' | 'place' | 'taxon_page_obs_photos'

Include observations where any of these properties match the value of the q parameter

quality_gradestring[]

Include observations with this quality grade

not_casual_excluding_captive'true' | 'false'

Exclude observations that are casual for any reason other than being marked captive

without_fieldstring

Exclude observations with this observation field

outlink_sourcestring

Include observations with outlinks from this source

updated_sincestring

Include observations updated since this time

viewer_idinteger

Must be combined with the reviewed parameter

reviewed'true' | 'false'

Filter by observations reviewed by the user with ID matching the value of the viewer_id parameter

expected_nearby'true' | 'false'

Filter by observations expected to occur nearby their location according to the latest iNaturalist Geomodel

fails_dqa_accurate'true' | 'false'

Filter by observations voted as not accurately depicting an organism or scene

fails_dqa_date'true' | 'false'

Filter by observations voted as not having an accurate date

fails_dqa_evidence'true' | 'false'

Filter by observations voted as not evidence of an organism

fails_dqa_location'true' | 'false'

Filter by observations voted as not having an accurate location

fails_dqa_needs_id'true' | 'false'

Filter by observations voted as the community ID cannot be improved

fails_dqa_recent'true' | 'false'

Filter by observations voted as not recent evidence of an organism

fails_dqa_subject'true' | 'false'

Filter by observations voted as not having evidence related to a single subject

fails_dqa_wild'true' | 'false'

Filter by observations voted as not wild

user_afterstring

Include observations created by users created after a date. Accepts dates with or without times, e.g. 2025-01-01, as well as relative day, month, or year, e.g. 10d, 2w, 1y

user_beforestring

Include observations created by users created before a date. Accepts dates with or without times, e.g. 2025-01-01, as well as relative day, month, or year, e.g. 10d, 2w, 1y

localestring

Returned taxon common names will be from this locale

preferred_place_idinteger

Returned taxon common names will prioritize common names from this place

ttlinteger

Set the Cache-Control HTTP header with this value as max-age, in seconds. This means subsequent identical requests may be cached on iNaturalist servers, and commonly within web browsers

pageinteger

Pagination page number

per_pageinteger

Number of results to return in a page

order'desc' | 'asc'

Sort order

order_by'created_at' | 'geo_score' | 'id' | 'observed_on' | 'random' | 'species_guess' | 'updated_at' | 'votes'

Attribute to sort on

only_id'true' | 'false'

Include observations with this ID

{"stackTrail":"paths:/observations:get:parameters:109:schema","oasType":"schema","type":"unknown"}

Attribute fields to return in the response

Headers

X-HTTP-Method-Overridestring

Response

A list of observations.

total_resultsinteger required
pageinteger required
per_pageinteger required