Search georeferenced wildlife sightings by area, date, taxon, quality grade, annotation, conservation status, observer, project, and licence. Returns a projected record per sighting with coordinates, licence, first photo, and identification counts. An area is given in exactly one form — place_id, the lat/lng/radius triple in kilometres, or a four-corner bounding box — and defaults to research-grade, wild-only records, which are echoed back on every call. Identifications and comments are deliberately not expandable here; fetch them for specific records with inaturalist_get_observation. page walks the first 10,000 results under any ordering; past 10,000, order by id descending (order_by "id", order "desc") and pass each page’s next_cursor as cursor.
View input schema
{
"type": "object",
"properties": {
"place_id": {
"description": "Numeric iNaturalist place id from inaturalist_find_places. Mutually exclusive with the lat/lng/radius triple and the bounding box.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"lat": {
"description": "Latitude of the search centre, in decimal degrees. Requires lng and radius.",
"type": "number",
"minimum": -90,
"maximum": 90
},
"lng": {
"description": "Longitude of the search centre, in decimal degrees. Requires lat and radius.",
"type": "number",
"minimum": -180,
"maximum": 180
},
"radius": {
"description": "Search radius around lat/lng, in KILOMETRES, greater than 0. Requires lat and lng. Ceiling: 20040; oversized values are clamped with notice.",
"type": "number"
},
"nelat": {
"description": "North-east corner latitude of the bounding box, at or north of swlat. All four corners or none.",
"type": "number",
"minimum": -90,
"maximum": 90
},
"nelng": {
"description": "North-east corner longitude of the bounding box. All four corners or none. West of swlng is accepted: it describes a box crossing the antimeridian.",
"type": "number",
"minimum": -180,
"maximum": 180
},
"swlat": {
"description": "South-west corner latitude of the bounding box. All four corners or none.",
"type": "number",
"minimum": -90,
"maximum": 90
},
"swlng": {
"description": "South-west corner longitude of the bounding box. All four corners or none.",
"type": "number",
"minimum": -180,
"maximum": 180
},
"taxon_id": {
"description": "Restrict to this taxon and its descendants. Resolve a name to an id with inaturalist_resolve_name.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"d1": {
"description": "Earliest observation date, YYYY-MM-DD. Inclusive. Must be on or before d2.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"d2": {
"description": "Latest observation date, YYYY-MM-DD. Inclusive.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"quality_grade": {
"default": [
"research"
],
"description": "Identification confidence tiers to include, normalized to unique values in first-appearance order. Defaults to research-grade only; adding \"needs_id\" roughly doubles the corpus and lowers identification confidence.",
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"research",
"needs_id",
"casual"
]
}
},
"captive": {
"default": false,
"description": "True returns captive and cultivated records only — zoo animals, garden plantings; false returns wild records only. Defaults to false. Captive records are graded casual, so pair true with \"casual\" in quality_grade.",
"type": "boolean"
},
"term_id": {
"description": "Annotation attribute ids, from inaturalist_list_reference topic controlled_terms — e.g. 1 for Life Stage. Multiple ids match any one annotation, not all annotations; arrays are membership sets, not positional pairs.",
"type": "array",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"term_value_id": {
"description": "Annotation value ids, from the same attribute listing — e.g. 6 for Larva. Requires term_id. Multiple ids match any one annotation with an attribute in term_id and a value in this set, not both annotations.",
"type": "array",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"iconic_taxa": {
"description": "Broad organism groups, by their scientific iconic-taxon name — Aves, not \"Birds\"; inaturalist_list_reference topic iconic_taxa lists them.",
"type": "array",
"items": {
"type": "string",
"enum": [
"Actinopterygii",
"Amphibia",
"Animalia",
"Arachnida",
"Aves",
"Chromista",
"Fungi",
"Insecta",
"Mammalia",
"Mollusca",
"Plantae",
"Protozoa",
"Reptilia",
"unknown"
]
}
},
"user_id": {
"description": "Restrict to one observer, by numeric user id from inaturalist_resolve_name type user. Mutually exclusive with user_login.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"user_login": {
"description": "Restrict to one observer, by login — the login on an inaturalist_resolve_name user candidate, a leaderboard entry, or an observation’s observer. Mutually exclusive with user_id.",
"type": "string",
"minLength": 1
},
"project_id": {
"description": "Restrict to observations in one project, by numeric project id from inaturalist_resolve_name type project.",
"type": "integer",
"minimum": 1,
"maximum": 2147483647
},
"ident_user_id": {
"description": "Restrict to records carrying an identification by this user, by numeric user id or login from inaturalist_resolve_name type user. The user’s own observations count.",
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
{
"type": "string",
"minLength": 1
}
]
},
"unobserved_by_user_id": {
"description": "Restrict to records of taxa this user has never observed, by numeric user id or login from inaturalist_resolve_name type user.",
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
{
"type": "string",
"minLength": 1
}
]
},
"hrank": {
"description": "Highest (coarsest) identification rank level to accept. Must be at or above lrank.",
"type": "string",
"enum": [
"stateofmatter",
"kingdom",
"phylum",
"subphylum",
"superclass",
"class",
"subclass",
"infraclass",
"subterclass",
"superorder",
"order",
"suborder",
"infraorder",
"parvorder",
"zoosection",
"zoosubsection",
"superfamily",
"epifamily",
"family",
"subfamily",
"supertribe",
"tribe",
"subtribe",
"genus",
"genushybrid",
"subgenus",
"section",
"subsection",
"complex",
"species",
"hybrid",
"subspecies",
"variety",
"form",
"infrahybrid"
]
},
"lrank": {
"description": "Lowest (finest) identification rank level to accept. Equal bounds select a level, including ranks sharing that level such as species and hybrid.",
"type": "string",
"enum": [
"stateofmatter",
"kingdom",
"phylum",
"subphylum",
"superclass",
"class",
"subclass",
"infraclass",
"subterclass",
"superorder",
"order",
"suborder",
"infraorder",
"parvorder",
"zoosection",
"zoosubsection",
"superfamily",
"epifamily",
"family",
"subfamily",
"supertribe",
"tribe",
"subtribe",
"genus",
"genushybrid",
"subgenus",
"section",
"subsection",
"complex",
"species",
"hybrid",
"subspecies",
"variety",
"form",
"infrahybrid"
]
},
"csi": {
"description": "IUCN-normalised conservation status codes. Matches global statuses plus statuses listed at exactly place_id, excluding ancestor-place listings; decode with inaturalist_list_reference topic conservation_status_codes.",
"type": "array",
"items": {
"type": "string",
"enum": [
"LC",
"NT",
"VU",
"EN",
"CR",
"EW",
"EX"
]
}
},
"threatened": {
"description": "Filter the observation’s indexed taxon as threatened at its location.",
"type": "boolean"
},
"native": {
"description": "Filter the observation’s indexed taxon as native at its location.",
"type": "boolean"
},
"introduced": {
"description": "Filter the observation’s indexed taxon as introduced at its location.",
"type": "boolean"
},
"endemic": {
"description": "Filter the observation’s indexed taxon as endemic at its location.",
"type": "boolean"
},
"month": {
"description": "Observed calendar months, 1–12, matched as alternatives.",
"type": "array",
"items": {
"type": "integer",
"minimum": 1,
"maximum": 12
}
},
"created_d1": {
"description": "Earliest upload date, YYYY-MM-DD. Inclusive. Must be on or before created_d2.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"created_d2": {
"description": "Latest upload date, YYYY-MM-DD. Inclusive.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"updated_since": {
"description": "Records updated since this calendar date (YYYY-MM-DD) or ISO datetime with timezone, e.g. 2026-10-30T12:00:00Z.",
"anyOf": [
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
{
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
}
]
},
"acc_below": {
"description": "Measured positional accuracy strictly below this positive threshold in metres, up to 2147483647; fractional metres are accepted. Records without measured accuracy are excluded.",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 2147483647
},
"obscuration": {
"description": "Observer or taxon geoprivacy values to include; none requires both to be open or unset. Multiple values match alternatives.",
"type": "array",
"items": {
"type": "string",
"enum": [
"obscured",
"private",
"none"
]
}
},
"identifications": {
"description": "Filter community identification agreement using one agreement category.",
"type": "string",
"enum": [
"most_agree",
"some_agree",
"most_disagree"
]
},
"licensed": {
"description": "Restrict to records whose own license_code is not null — any licence, NonCommercial and NoDerivatives variants included. For specific licences, use license.",
"type": "boolean"
},
"photo_licensed": {
"description": "Restrict to records with at least one licensed photo, under any licence. For specific licences, use photo_license.",
"type": "boolean"
},
"license": {
"description": "Restrict to records whose own license_code is one of these, e.g. [\"cc-by\",\"cc0\"] for reuse with attribution only. Decode the codes with inaturalist_list_reference topic licenses; all-rights-reserved records have no code to pass.",
"type": "array",
"items": {
"type": "string",
"enum": [
"cc-by",
"cc-by-nc",
"cc-by-nd",
"cc-by-sa",
"cc-by-nc-nd",
"cc-by-nc-sa",
"cc0"
]
}
},
"sounds": {
"description": "True selects observations with sounds; false selects those without. Omit for either. Use include: [\"sounds\"] to expand sound metadata; no media is downloaded.",
"type": "boolean"
},
"photo_license": {
"description": "Restrict to records carrying at least one photo under one of these licence codes. Matched independently of the record’s own license_code, so check each photo’s license_code before reusing it.",
"type": "array",
"items": {
"type": "string",
"enum": [
"cc-by",
"cc-by-nc",
"cc-by-nd",
"cc-by-sa",
"cc-by-nc-nd",
"cc-by-nc-sa",
"cc0"
]
}
},
"q": {
"description": "Free text matched across observation properties.",
"type": "string",
"minLength": 1
},
"search_on": {
"description": "Narrow what q matches against. Requires q.",
"type": "string",
"enum": [
"names",
"tags",
"description",
"place"
]
},
"order_by": {
"description": "Sort field. Set \"id\" with order \"desc\" to walk past 10,000 results: that is the one ordering next_cursor continues, so it is the only one that issues a next_cursor. A cursor forces it.",
"default": "observed_on",
"type": "string",
"enum": [
"created_at",
"geo_score",
"id",
"observed_on",
"random",
"species_guess",
"updated_at",
"votes"
]
},
"order": {
"description": "Sort direction.",
"default": "desc",
"type": "string",
"enum": [
"asc",
"desc"
]
},
"page": {
"description": "Page number within the first 10,000 results, under any ordering. Defaults to 1. Mutually exclusive with cursor.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"cursor": {
"description": "next_cursor from a previous id-descending page, to continue past the 10,000-result window — a positive integer observation id. Mutually exclusive with page, and forces order_by \"id\", order \"desc\".",
"type": "string",
"pattern": "^[1-9]\\d*$"
},
"per_page": {
"default": 10,
"description": "Records fetched per page. Complete records may be deferred to keep the response within its byte budget; retrieve deferred ids through inaturalist_get_observation with the same include values. Ceiling: 25; oversized values are clamped.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"include": {
"description": "Embedded arrays to expand per record. Check photo_count and sound_count first — expanding costs context.",
"type": "array",
"items": {
"type": "string",
"enum": [
"photos",
"annotations",
"sounds"
]
}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}