latestOpenAPI 3.0.02026-08-10135177718.4 KB

f739db716aaf

Observations

Fetch observation counts by iconic taxon

Given zero to many of same parameters as the observation search API, returns observation counts grouped by iconic taxon. Results include an entry with a null taxon counting observations without an iconic taxon, equivalent to filtering observations with iconic_taxa=unknown

get/observations/iconic_taxa_counts

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/iconic_taxa_counts:get:parameters:109:schema","oasType":"schema","type":"unknown"}

Attribute fields to return in the response

Headers

X-HTTP-Method-Overridestring

Response

An array of observation counts by iconic taxon.

total_resultsinteger required
pageinteger required
per_pageinteger required