Models#

Data models that represent iNaturalist API response objects. See Models section for usage details.

Annotation

An annotation, meaning a controlled term value applied by a user to an observation.

Application

An iNaturalist mobile or third-party application

Checklist

A taxon checklist (aka "original life list")

Comment

An observation comment, based on the schema of comments from GET /observations.

ConservationStatus

The conservation status of a taxon in a given location, based on the schema of:

ControlledTerm

A controlled term, based on the schema of GET /controlled_terms.

ControlledTermCount

A count + histogram of a controlled term and value

ControlledTermCounts

Used with GET /observations/popular_field_values.

ControlledTermValue

A controlled term value, based on the schema of GET /controlled_terms.

EstablishmentMeans

The establishment means for a taxon in a given location

Fave

An observation favorited by a user

Flag

A flag on an observation

ID

alias of Identification

IconPhoto

Class used for displaying an iconic taxon in place of a taxon photo

Identification

An observation identification, based on the schema of GET /identifications.

LifeList

A user's life list, based on the schema of GET /observations/taxonomy

ListedTaxon

A taxon with additional stats associated with a list (aka "original life list"), based on the schema of:

Message

A message from the user's inbox, based on the schema of GET /messages

OFD

alias of ObservationField

OFV

alias of ObservationFieldValue

Observation

An observation, based the schema of GET /observations

ObservationField

An observation field definition, based on the schema of GET /observation_fields.

ObservationFieldValue

An observation field value, based on the schema of Observation.ofvs from GET /observations.

Observations

A collection of observations

Photo

An observation photo, based on the schema of photos from:

Place

A curated or community-contributed place.

Project

An iNaturalist project, based on the schema of GET /projects.

ProjectObservation

Metadata about an observation that has been added to a project

ProjectObservationField

An ObservationField with additional project-specific information

ProjectUser

A User with additional project-specific information

QualityMetric

An observation quality metric added by a user to an observation

SearchResult

A search result of any type, based on the schema of GET /search.

Sound

An observation sound, based on the schema of sounds from:

Taxon

An iNaturalist taxon, based on the schema of GET /taxa.

TaxonCount

A Taxon with an associated count, used in a TaxonCounts collection

TaxonCounts

A collection of taxa with an associated counts.

TaxonSummary

Information about an observation's taxon, within the context of the observation's location.

User

An iNaturalist user, based on the schema of GET /users/{id}

UserCount

An iNaturalist user, with an associated count of filtered IDs or observations

UserCounts

A collection of users with an associated counts

Vote

A vote on a data quality assessment metric