API Reference

iNaturalist currently provides three API versions:

• The original Rails-based API (v0). It is likely that this API will be deprecated at some point in the future.

• The Node-based API (v1) allows read and write access to most iNaturalist resources, and is generally faster and more consistent than the v0 API.

• The v2 API is currently in development, and will eventually replace both the v0 and v1 APIs. see this forum thread if you are interested in testing it out.

Pyinaturalist provides functions to use the v0 and v1 APIs, with experimental v2 features coming soon. Also see Endpoint Summary for an overview of which iNaturalist endpoints are currently implemented.

Main API Modules

• V0
  • Observation Fields
  • Observations
• V1
  • Controlled Terms
  • Identifications
  • Messages
  • Observation Fields
  • Observations
  • Places
  • Posts
  • Projects
  • Search
  • Taxa
  • Users
• V2
  • Observations
• Client
• Controllers
• Models

Additional Utility Modules

• Auth
• Converters
• Exceptions
• Formatters
• Paginator
• Request Params
• Session