OptionalbodyOptionalpathOptionalqueryOptionalacc?: booleanOptionalaccAbove?: stringMust have a positional accuracy above this value (meters)
OptionalaccBelow?: stringMust have a positional accuracy below this value (meters)
OptionalaccBelowOrUnknown?: stringPositional accuracy must be below this value (in meters) or be unknown
OptionalannotationUserId?: string[]Must have an annotation created by this user
OptionalapplyProjectRulesFor?: stringMust match the rules of the project with this ID or slug
Optionalcaptive?: booleanCaptive or cultivated observations
OptionalcreatedD1?: stringMust be created at or after this time
OptionalcreatedD2?: stringMust be created at or before this time
OptionalcreatedDay?: string[]Must be created within this day of the month
OptionalcreatedMonth?: string[]Must be created within this month
OptionalcreatedOn?: stringMust be created on this date
OptionalcreatedYear?: string[]Must be created within this year
Optionalcs?: stringTaxon must have this conservation status code. If
the place_id parameter is also specified, this will only consider
statuses specific to that place
Optionalcsa?: stringTaxon must have a conservation status from this authority. If
the place_id parameter is also specified, this will only consider
statuses specific to that place
Optionalcsi?: "LC" | "NT" | "VU" | "EN" | "CR" | "EW" | "EX"Taxon must have this IUCN conservation status. If
the place_id parameter is also specified, this will only consider
statuses specific to that place
Optionald1?: stringMust be observed on or after this date
Optionald2?: stringMust be observed on or before this date
Optionalday?: string[]Must be observed within this day of the month
Optionalendemic?: booleanObservations whose taxa are endemic to their location
OptionalexpectedNearby?: booleanObservation taxon is expected nearby
Optionalgeo?: booleanObservations that are georeferenced
Optionalgeoprivacy?: "obscured" | "obscured_private" | "open" | "private"Must have this geoprivacy setting
Optionalhour?: string[]Must be observed within this hour of the day
Optionalhrank?: Taxon must have this rank or lower
OptionaliconicTaxa?: Taxon must by within this iconic taxon
Optionalid?: string[]Must have this ID
OptionalidAbove?: stringMust have an ID above this value
OptionalidBelow?: stringMust have an ID below this value
Optionalidentifications?: "most_agree" | "most_disagree" | "some_agree"Identifications must meet these criteria
Optionalidentified?: booleanObservations that have community identifications
OptionalidentUserId?: numberObservations identified by a particular user
OptionalidPlease?: booleanObservations with the deprecated ID, Please! flag. Note that this will return observations, but that this attribute is no longer used.
Optionalintroduced?: booleanObservations whose taxa are introduced in their location
Optionallat?: numberMust be within a {radius} kilometer circle around this lat/lng
(*lat, *lng, radius)
Optionallicense?: Observation must have this license
Optionallicensed?: booleanLicense attribute of an observation must not be null
OptionallistId?: numberTaxon must be in the list with this ID
Optionallng?: numberMust be within a {radius} kilometer circle around this lat/lng
(*lat, *lng, radius)
Optionallocale?: stringLocale preference for taxon common names
Optionallrank?: Taxon must have this rank or higher
Optionalmappable?: booleanObservations that show on map tiles
Optionalmonth?: string[]Must be observed within this month
Optionalnative?: booleanObservations whose taxa are native to their location
Optionalnelat?: numberMust be within this bounding box (*nelat, *nelng, *swlat, *swlng)
Optionalnelng?: numberMust be within this bounding box (*nelat, *nelng, *swlat, *swlng)
OptionalnotId?: string[]Must not have this ID
OptionalnotInProject?: stringMust not be in the project with this ID or slug
OptionalnotMatchingProjectRulesFor?: stringMust not match the rules of the project with this ID or slug
Optionalobscuration?: "obscured" | "private" | "none"Must have geoprivacy or taxon_geoprivacy fields matching these values
OptionalobservationAccuracyExperimentId?: number[]Must included in this observation accuracy experiment
OptionalobservedOn?: stringMust be observed on this date
OptionalofvDatatype?: string[]Must have an observation field value with this datatype
OptionalonlyId?: booleanReturn only the record IDs
Optionalorder?: "desc" | "asc"Sort order
OptionalorderBy?: Sort field
OptionaloutOfRange?: booleanObservations whose taxa are outside their known ranges
Optionalpage?: stringPagination page number
Optionalpcid?: booleanObservations identified by the curator of a project. If
the project_id parameter is also specified, this will only consider
observations identified by curators of the specified project(s)
OptionalperPage?: stringNumber of results to return in a page. The maximum value is generally
200 unless otherwise noted
OptionalphotoLicense?: Must have at least one photo with this license
OptionalphotoLicensed?: booleanLicense attribute of at least one photo of an observation must not be null
Optionalphotos?: booleanObservations with photos
OptionalplaceId?: number[]Must be observed within the place with this ID
Optionalpopular?: booleanObservations that have been favorited by at least one user
OptionalpreferredPlaceId?: numberPlace preference for regional taxon common names
OptionalprojectId?: string[]Must be added to the project this ID or slug
Optionalq?: stringSearch observation properties. Can be combined with search_on
OptionalqualityGrade?: "casual" | "needs_id" | "research"Must have this quality grade
Optionalradius?: stringMust be within a {radius} kilometer circle around this lat/lng
(*lat, *lng, radius)
Optionalrank?: Taxon must have this rank
Optionalreviewed?: booleanObservations have been reviewed by the user with ID equal to
the value of the viewer_id parameter
OptionalsearchOn?: "names" | "tags" | "description" | "place"Properties to search on, when combined with q.
Searches across all properties by default
OptionalsiteId?: string[]Must be affiliated with the iNaturalist network website with this ID
OptionalsoundLicense?: Must have at least one sound with this license
Optionalsounds?: booleanObservations with sounds
Optionalswlat?: numberMust be within this bounding box (*nelat, *nelng, *swlat, *swlng)
Optionalswlng?: numberMust be within this bounding box (*nelat, *nelng, *swlat, *swlng)
OptionaltaxonGeoprivacy?: "obscured" | "obscured_private" | "open" | "private"Filter observations by the most conservative geoprivacy applied by a conservation status associated with one of the taxa proposed in the current identifications.
OptionaltaxonId?: string[]Only show observations of these taxa and their descendants
OptionaltaxonIsActive?: booleanObservations of active taxon concepts
OptionaltaxonName?: string[]Taxon must have a scientific or common name matching this string
OptionaltermId?: number[]Must have an annotation using this controlled term ID
OptionaltermIdOrUnknown?: number[]Must be combined with the term_value_id or the without_term_value_id parameter.
Must have an annotation using this controlled term ID and associated term value IDs
or be missing this annotation.
OptionaltermValueId?: number[]Must have an annotation using this controlled value ID. Must be combined
with the term_id parameter
Optionalthreatened?: booleanObservations whose taxa are threatened in their location
Optionalttl?: stringSet the Cache-Control HTTP header with this value as max-age, in
seconds. This means subsequent identical requests will be cached on
iNaturalist servers, and commonly within web browsers
OptionalunobservedByUserId?: numberMust not be of a taxon previously observed by this user
OptionalupdatedSince?: stringMust be updated since this time
OptionaluserId?: string[]User must have this ID or login
OptionaluserLogin?: string[]User must have this login
Optionalverifiable?: booleanObservations with a quality_grade of either needs_id or
research. Equivalent to quality_grade=needs_id,research
OptionalviewerId?: stringSee reviewed
OptionalwithoutTaxonId?: string[]Exclude observations of these taxa and their descendants
OptionalwithoutTermId?: numberExclude observations with annotations using this controlled value ID.
OptionalwithoutTermValueId?: number[]Exclude observations with annotations using this controlled value ID.
Must be combined with the term_id parameter
Optionalyear?: string[]Must be observed within this year
Whether or not positional accuracy / coordinate uncertainty has been specified