iNaturalist

iNaturalist Observations API

CRUD, search, faving, quality metrics, stats, and more

Documentation GitHub OpenAPI

Operations 24

GET /observations/{id} Observation Details

PUT /observations/{id} Observation Update

DELETE /observations/{id} Observation Delete

POST /observations/{id}/fave Observations Fave

DELETE /observations/{id}/unfave Observations Unfave

POST /observations/{id}/review Observations Review

DELETE /observations/{id}/review Observations Unreview

GET /observations/{id}/subscriptions Observation Subscriptions

POST /observations/{id}/quality/{metric} Quality Metric Set

DELETE /observations/{id}/quality/{metric} Quality Metric Delete

GET /observations/{id}/taxon_summary Observation Taxon Summary

POST /subscriptions/observation/{id}/subscribe Observation Subscribe

POST /votes/vote/observation/{id} Observation Vote

DELETE /votes/unvote/observation/{id} Observation Unvote

GET /observations Observation Search

POST /observations Observation Create

GET /observations/deleted Observations Deleted

GET /observations/histogram Observation Histogram

GET /observations/identifiers Observation Identifiers

GET /observations/observers Observation Observers

GET /observations/popular_field_values Observation Popular Field Values

GET /observations/species_counts Observation Species Counts

GET /observations/updates Observation User Updates

PUT /observations/{id}/viewed_updates Observation Field Value Update

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/inaturalist-observations-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: iNaturalist Annotations Observations API
  description: '# https://api.inaturalist.org/v1/


    [iNaturalist](https://www.inaturalist.org/) is a global community of

    naturalists, scientists, and members of the public sharing over a million

    wildlife sightings to teach one another about the natural world while

    creating high quality citizen science data for science and conservation.


    These API methods return data in JSON/JSONP and PNG response formats. They

    are meant to supplement the existing [iNaturalist

    API](https://www.inaturalist.org/pages/api+reference), implemented in Ruby

    on Rails, which has more functionality and supports more write operations,

    but tends to be slower and have less consistent response formats. Visit our

    [developers page](https://www.inaturalist.org/pages/developers) for more

    information. Write operations that expect and return JSON describe a single

    `body` parameter that represents the request body, which should be specified

    as JSON. See the "Model" of each body parameter for attributes that we

    accept in these JSON objects.


    Multiple values for a single URL parameter should be separated by commas,

    e.g. `taxon_id=1,2,3`.


    Map tiles are generated using the

    [node-mapnik](https://github.com/mapnik/node-mapnik) library, following the

    XYZ map tiling scheme. The "Observation Tile" methods accept nearly all the

    parameters of the observation search APIs, and will generate map tiles

    reflecting the same observations returned by searches. These

    "Observation Tile" methods have corresponding

    [UTFGrid](https://github.com/mapbox/utfgrid-spec) JSON

    responses which return information needed to make interactive maps.


    Authentication in the Node API is handled via JSON Web Tokens (JWT). To

    obtain one, make an [OAuth-authenticated

    request](http://www.inaturalist.org/pages/api+reference#auth) to

    https://www.inaturalist.org/users/api_token. Each JWT will expire after 24

    hours. Authentication required for all PUT and POST requests. Some GET

    requests will also include private information like hidden coordinates if

    the authenticated user has permission to view them.


    Photos served from https://static.inaturalist.org and

    https://inaturalist-open-data.s3.amazonaws.com have multiple size

    variants and not all size variants are returned in responses. To access

    other sizes, the photo URL can be modified to replace only the size

    qualifier (each variant shares the exact same extension). The domain a photo

    is hosted under reflects the license under which the photo is being shared,

    and the domain may change over time if the license changes. Photos in

    the `inaturalist-open-data` domain are shared under open licenses. These can

    be accessed in bulk in the [iNaturalist AWS Open Dataset](

    https://registry.opendata.aws/inaturalist-open-data/). Photos in the

    `static.inaturalist.org` domain do not have open licenses.


    The available photo sizes are:

    * original (max 2048px in either dimension)

    * large (max 1024px in either dimension)

    * medium (max 500px in either dimension)

    * small (max 240px in either dimension)

    * thumb (max 100px in either dimension)

    * square (75px square)


    iNaturalist Website: https://www.inaturalist.org/


    Open Source Software: https://github.com/inaturalist/


    ## Terms of Use


    Use of this API is subject to the iNaturalist

    [Terms of Service](https://www.inaturalist.org/terms) and

    [Privacy Policy](https://www.inaturalist.org/privacy). We will block any

    use of our API that violates our Terms or Privacy Policy without notice.

    The API is intended to support application development, not data scraping.

    For pre- generated data exports, see

    https://www.inaturalist.org/pages/developers.


    Please note that we throttle API usage to a max of 100 requests per minute,

    though we ask that you try to keep it to 60 requests per minute or lower,

    and to keep under 10,000 requests per day. If we notice usage that has

    serious impact on our performance we may institute blocks without

    notification.


    Terms of Service: https://www.inaturalist.org/terms


    Privacy Policy: https://www.inaturalist.org/privacy

    '
  version: 1.3.0
servers:
- url: /v1
tags:
- name: Observations
  description: CRUD, search, faving, quality metrics, stats, and more
paths:
  /observations/{id}:
    get:
      summary: Observation Details
      description: 'Given an ID, or an array of IDs in comma-delimited format, returns

        corresponding observations. A maximum of 200 results will be returned

        '
      parameters:
      - $ref: '#/components/parameters/path_multi_id'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: 'Returns an object with metadata and an array of observations

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ObservationsShowResponse'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    put:
      summary: Observation Update
      description: 'Update an observation

        '
      parameters:
      - $ref: '#/components/parameters/path_id'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostObservation'
        description: Comment object
    delete:
      summary: Observation Delete
      description: 'Delete an observation

        '
      parameters:
      - $ref: '#/components/parameters/path_id'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
  /observations/{id}/fave:
    post:
      summary: Observations Fave
      description: 'Fave an observation

        '
      parameters:
      - $ref: '#/components/parameters/path_id'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
  /observations/{id}/unfave:
    delete:
      summary: Observations Unfave
      description: 'Unfave an observation

        '
      parameters:
      - $ref: '#/components/parameters/path_id'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
  /observations/{id}/review:
    post:
      summary: Observations Review
      description: 'Review an observation

        '
      parameters:
      - $ref: '#/components/parameters/path_id'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
    delete:
      summary: Observations Unreview
      description: 'Unreview an observation

        '
      parameters:
      - $ref: '#/components/parameters/path_id'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
  /observations/{id}/subscriptions:
    get:
      summary: Observation Subscriptions
      description: 'Fetches any subscriptions the current user has to this observation

        or the observer

        '
      parameters:
      - $ref: '#/components/parameters/path_id'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
  /observations/{id}/quality/{metric}:
    post:
      summary: Quality Metric Set
      description: 'Set the value of a quality metric

        '
      parameters:
      - $ref: '#/components/parameters/path_id'
      - $ref: '#/components/parameters/path_metric'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostQuality'
        description: Quality object
    delete:
      summary: Quality Metric Delete
      description: 'Delete a quality metric

        '
      parameters:
      - $ref: '#/components/parameters/path_id'
      - $ref: '#/components/parameters/path_metric'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
  /observations/{id}/taxon_summary:
    get:
      summary: Observation Taxon Summary
      description: 'Fetches information about this observation''s taxon, within the context

        of this observation''s location

        '
      parameters:
      - $ref: '#/components/parameters/path_id'
      tags:
      - Observations
      responses:
        '200':
          description: OK
  /subscriptions/observation/{id}/subscribe:
    post:
      summary: Observation Subscribe
      description: 'Toggles current user''s subscription to this observation. If the logged-in

        user is not subscribed, POSTing here will subscribe them. If they are already

        subscribed, this will remove the subscription

        '
      parameters:
      - $ref: '#/components/parameters/path_id'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
  /votes/vote/observation/{id}:
    post:
      summary: Observation Vote
      description: 'Vote on an observation. A vote with an empty `scope` is recorded as a

        `fave` of the observation. A vote with scope `needs_id` is recorded as a

        vote on the Quality Grade criterion "can the Community ID still be

        confirmed or improved?", and can be an up or down vote

        '
      parameters:
      - $ref: '#/components/parameters/path_id'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostObservationVote'
        description: Vote object
  /votes/unvote/observation/{id}:
    delete:
      summary: Observation Unvote
      description: Remove a vote from an observation
      parameters:
      - $ref: '#/components/parameters/path_id'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostObservationVote'
        description: Vote object
  /observations:
    get:
      summary: Observation Search
      description: 'Given zero to many of following parameters, returns observations

        matching the search criteria. The large size of the observations index

        prevents us from supporting the `page` parameter when retrieving records

        from large result sets. If you need to retrieve large numbers of

        records, use the `per_page` and `id_above` or `id_below` parameters

        instead.

        '
      parameters:
      - $ref: '#/components/parameters/acc'
      - $ref: '#/components/parameters/captive'
      - $ref: '#/components/parameters/endemic'
      - $ref: '#/components/parameters/geo'
      - $ref: '#/components/parameters/id_please'
      - $ref: '#/components/parameters/identified'
      - $ref: '#/components/parameters/introduced'
      - $ref: '#/components/parameters/mappable'
      - $ref: '#/components/parameters/native'
      - $ref: '#/components/parameters/out_of_range'
      - $ref: '#/components/parameters/pcid'
      - $ref: '#/components/parameters/photos'
      - $ref: '#/components/parameters/popular'
      - $ref: '#/components/parameters/sounds'
      - $ref: '#/components/parameters/taxon_is_active'
      - $ref: '#/components/parameters/threatened'
      - $ref: '#/components/parameters/verifiable'
      - $ref: '#/components/parameters/licensed'
      - $ref: '#/components/parameters/photo_licensed'
      - $ref: '#/components/parameters/expected_nearby'
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/not_id'
      - $ref: '#/components/parameters/license'
      - $ref: '#/components/parameters/ofv_datatype'
      - $ref: '#/components/parameters/photo_license'
      - $ref: '#/components/parameters/place_id'
      - $ref: '#/components/parameters/project_id'
      - $ref: '#/components/parameters/rank'
      - $ref: '#/components/parameters/site_id'
      - $ref: '#/components/parameters/sound_license'
      - $ref: '#/components/parameters/taxon_id'
      - $ref: '#/components/parameters/without_taxon_id'
      - $ref: '#/components/parameters/taxon_name'
      - $ref: '#/components/parameters/user_id'
      - $ref: '#/components/parameters/user_login'
      - $ref: '#/components/parameters/ident_user_id'
      - $ref: '#/components/parameters/hour'
      - $ref: '#/components/parameters/day'
      - $ref: '#/components/parameters/month'
      - $ref: '#/components/parameters/year'
      - $ref: '#/components/parameters/created_day'
      - $ref: '#/components/parameters/created_month'
      - $ref: '#/components/parameters/created_year'
      - $ref: '#/components/parameters/term_id'
      - $ref: '#/components/parameters/term_value_id'
      - $ref: '#/components/parameters/without_term_id'
      - $ref: '#/components/parameters/without_term_value_id'
      - $ref: '#/components/parameters/term_id_or_unknown'
      - $ref: '#/components/parameters/annotation_user_id'
      - $ref: '#/components/parameters/acc_above'
      - $ref: '#/components/parameters/acc_below'
      - $ref: '#/components/parameters/acc_below_or_unknown'
      - $ref: '#/components/parameters/d1'
      - $ref: '#/components/parameters/d2'
      - $ref: '#/components/parameters/created_d1'
      - $ref: '#/components/parameters/created_d2'
      - $ref: '#/components/parameters/created_on'
      - $ref: '#/components/parameters/observed_on'
      - $ref: '#/components/parameters/unobserved_by_user_id'
      - $ref: '#/components/parameters/apply_project_rules_for'
      - $ref: '#/components/parameters/cs'
      - $ref: '#/components/parameters/csa'
      - $ref: '#/components/parameters/csi'
      - $ref: '#/components/parameters/geoprivacy'
      - $ref: '#/components/parameters/taxon_geoprivacy'
      - $ref: '#/components/parameters/obscuration'
      - $ref: '#/components/parameters/hrank'
      - $ref: '#/components/parameters/lrank'
      - $ref: '#/components/parameters/iconic_taxa'
      - $ref: '#/components/parameters/id_above'
      - $ref: '#/components/parameters/id_below'
      - $ref: '#/components/parameters/identifications'
      - $ref: '#/components/parameters/lat'
      - $ref: '#/components/parameters/lng'
      - $ref: '#/components/parameters/radius'
      - $ref: '#/components/parameters/nelat'
      - $ref: '#/components/parameters/nelng'
      - $ref: '#/components/parameters/swlat'
      - $ref: '#/components/parameters/swlng'
      - $ref: '#/components/parameters/list_id'
      - $ref: '#/components/parameters/not_in_project'
      - $ref: '#/components/parameters/not_matching_project_rules_for'
      - $ref: '#/components/parameters/observation_accuracy_experiment_id'
      - $ref: '#/components/parameters/fails_dqa_accurate'
      - $ref: '#/components/parameters/fails_dqa_date'
      - $ref: '#/components/parameters/fails_dqa_evidence'
      - $ref: '#/components/parameters/fails_dqa_location'
      - $ref: '#/components/parameters/fails_dqa_needs_id'
      - $ref: '#/components/parameters/fails_dqa_recent'
      - $ref: '#/components/parameters/fails_dqa_subject'
      - $ref: '#/components/parameters/fails_dqa_wild'
      - $ref: '#/components/parameters/q'
      - $ref: '#/components/parameters/search_on'
      - $ref: '#/components/parameters/quality_grade'
      - $ref: '#/components/parameters/updated_since'
      - $ref: '#/components/parameters/viewer_id'
      - $ref: '#/components/parameters/reviewed'
      - $ref: '#/components/parameters/locale'
      - $ref: '#/components/parameters/preferred_place_id'
      - $ref: '#/components/parameters/ttl'
      - $ref: '#/components/parameters/page'
      - $ref: '#/components/parameters/per_page'
      - $ref: '#/components/parameters/order'
      - $ref: '#/components/parameters/order_by'
      - $ref: '#/components/parameters/only_id'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: 'Returns an object with metadata and an array of observations

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ObservationsResponse'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
    post:
      summary: Observation Create
      description: 'Create an observation

        '
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostObservation'
        description: Comment object
  /observations/deleted:
    get:
      summary: Observations Deleted
      description: 'Given a starting date, return an array of IDs of the authenticated

        user''s observations that have been deleted since that date. Requires

        authentication

        '
      parameters:
      - $ref: '#/components/parameters/since'
      tags:
      - Observations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
  /observations/histogram:
    get:
      summary: Observation Histogram
      description: 'Given zero to many of following parameters, returns histogram data about

        observations matching the search criteria

        '
      parameters:
      - $ref: '#/components/parameters/acc'
      - $ref: '#/components/parameters/captive'
      - $ref: '#/components/parameters/endemic'
      - $ref: '#/components/parameters/geo'
      - $ref: '#/components/parameters/id_please'
      - $ref: '#/components/parameters/identified'
      - $ref: '#/components/parameters/introduced'
      - $ref: '#/components/parameters/mappable'
      - $ref: '#/components/parameters/native'
      - $ref: '#/components/parameters/out_of_range'
      - $ref: '#/components/parameters/pcid'
      - $ref: '#/components/parameters/photos'
      - $ref: '#/components/parameters/popular'
      - $ref: '#/components/parameters/sounds'
      - $ref: '#/components/parameters/taxon_is_active'
      - $ref: '#/components/parameters/threatened'
      - $ref: '#/components/parameters/verifiable'
      - $ref: '#/components/parameters/licensed'
      - $ref: '#/components/parameters/photo_licensed'
      - $ref: '#/components/parameters/expected_nearby'
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/not_id'
      - $ref: '#/components/parameters/license'
      - $ref: '#/components/parameters/ofv_datatype'
      - $ref: '#/components/parameters/photo_license'
      - $ref: '#/components/parameters/place_id'
      - $ref: '#/components/parameters/project_id'
      - $ref: '#/components/parameters/rank'
      - $ref: '#/components/parameters/site_id'
      - $ref: '#/components/parameters/sound_license'
      - $ref: '#/components/parameters/taxon_id'
      - $ref: '#/components/parameters/without_taxon_id'
      - $ref: '#/components/parameters/taxon_name'
      - $ref: '#/components/parameters/user_id'
      - $ref: '#/components/parameters/user_login'
      - $ref: '#/components/parameters/ident_user_id'
      - $ref: '#/components/parameters/hour'
      - $ref: '#/components/parameters/day'
      - $ref: '#/components/parameters/month'
      - $ref: '#/components/parameters/year'
      - $ref: '#/components/parameters/created_day'
      - $ref: '#/components/parameters/created_month'
      - $ref: '#/components/parameters/created_year'
      - $ref: '#/components/parameters/term_id'
      - $ref: '#/components/parameters/term_value_id'
      - $ref: '#/components/parameters/without_term_id'
      - $ref: '#/components/parameters/without_term_value_id'
      - $ref: '#/components/parameters/term_id_or_unknown'
      - $ref: '#/components/parameters/annotation_user_id'
      - $ref: '#/components/parameters/acc_above'
      - $ref: '#/components/parameters/acc_below'
      - $ref: '#/components/parameters/acc_below_or_unknown'
      - $ref: '#/components/parameters/d1'
      - $ref: '#/components/parameters/d2'
      - $ref: '#/components/parameters/created_d1'
      - $ref: '#/components/parameters/created_d2'
      - $ref: '#/components/parameters/created_on'
      - $ref: '#/components/parameters/observed_on'
      - $ref: '#/components/parameters/unobserved_by_user_id'
      - $ref: '#/components/parameters/apply_project_rules_for'
      - $ref: '#/components/parameters/cs'
      - $ref: '#/components/parameters/csa'
      - $ref: '#/components/parameters/csi'
      - $ref: '#/components/parameters/geoprivacy'
      - $ref: '#/components/parameters/taxon_geoprivacy'
      - $ref: '#/components/parameters/obscuration'
      - $ref: '#/components/parameters/hrank'
      - $ref: '#/components/parameters/lrank'
      - $ref: '#/components/parameters/iconic_taxa'
      - $ref: '#/components/parameters/id_above'
      - $ref: '#/components/parameters/id_below'
      - $ref: '#/components/parameters/identifications'
      - $ref: '#/components/parameters/lat'
      - $ref: '#/components/parameters/lng'
      - $ref: '#/components/parameters/radius'
      - $ref: '#/components/parameters/nelat'
      - $ref: '#/components/parameters/nelng'
      - $ref: '#/components/parameters/swlat'
      - $ref: '#/components/parameters/swlng'
      - $ref: '#/components/parameters/list_id'
      - $ref: '#/components/parameters/not_in_project'
      - $ref: '#/components/parameters/not_matching_project_rules_for'
      - $ref: '#/components/parameters/observation_accuracy_experiment_id'
      - $ref: '#/components/parameters/fails_dqa_accurate'
      - $ref: '#/components/parameters/fails_dqa_date'
      - $ref: '#/components/parameters/fails_dqa_evidence'
      - $ref: '#/components/parameters/fails_dqa_location'
      - $ref: '#/components/parameters/fails_dqa_needs_id'
      - $ref: '#/components/parameters/fails_dqa_recent'
      - $ref: '#/components/parameters/fails_dqa_subject'
      - $ref: '#/components/parameters/fails_dqa_wild'
      - $ref: '#/components/parameters/q'
      - $ref: '#/components/parameters/search_on'
      - $ref: '#/components/parameters/quality_grade'
      - $ref: '#/components/parameters/updated_since'
      - $ref: '#/components/parameters/viewer_id'
      - $ref: '#/components/parameters/reviewed'
      - $ref: '#/components/parameters/locale'
      - $ref: '#/components/parameters/preferred_place_id'
      - $ref: '#/components/parameters/ttl'
      - $ref: '#/components/parameters/date_field'
      - $ref: '#/components/parameters/interval'
      tags:
      - Observations
      responses:
        '200':
          description: 'Returns an object with metadata and an array of histogram data

            '
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /observations/identifiers:
    get:
      summary: Observation Identifiers
      description: 'Given zero to many of following parameters, returns identifiers of

        observations matching the search criteria and the count of

        observations they have identified, ordered by count descending. A

        maximum of 500 results will be returned

        '
      parameters:
      - $ref: '#/components/parameters/acc'
      - $ref: '#/components/parameters/captive'
      - $ref: '#/components/parameters/endemic'
      - $ref: '#/components/parameters/geo'
      - $ref: '#/components/parameters/id_please'
      - $ref: '#/components/parameters/identified'
      - $ref: '#/components/parameters/introduced'
      - $ref: '#/components/parameters/mappable'
      - $ref: '#/components/parameters/native'
      - $ref: '#/components/parameters/out_of_range'
      - $ref: '#/components/parameters/pcid'
      - $ref: '#/components/parameters/photos'
      - $ref: '#/components/parameters/popular'
      - $ref: '#/components/parameters/sounds'
      - $ref: '#/components/parameters/taxon_is_active'
      - $ref: '#/components/parameters/threatened'
      - $ref: '#/components/parameters/verifiable'
      - $ref: '#/components/parameters/licensed'
      - $ref: '#/components/parameters/photo_licensed'
      - $ref: '#/components/parameters/expected_nearby'
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/not_id'
      - $ref: '#/components/parameters/license'
      - $ref: '#/components/parameters/ofv_datatype'
      - $ref: '#/components/parameters/photo_license'
      - $ref: '#/components/parameters/place_id'
      - $ref: '#/components/parameters/project_id'
      - $ref: '#/components/parameters/rank'
      - $ref: '#/components/parameters/site_id'
      - $ref: '#/components/parameters/sound_license'
      - $ref: '#/components/parameters/taxon_id'
      - $ref: '#/components/parameters/without_taxon_id'
      - $ref: '#/components/parameters/taxon_name'
      - $ref: '#/components/parameters/user_id'
      - $ref: '#/components/parameters/user_login'
      - $ref: '#/components/parameters/ident_user_id'
      - $ref: '#/components/parameters/hour'
      - $ref: '#/components/parameters/day'
      - $ref: '#/components/parameters/month'
      - $ref: '#/components/parameters/year'
      - $ref: '#/components/parameters/created_day'
      - $ref: '#/components/parameters/created_month'
      - $ref: '#/components/parameters/created_year'
      - $ref: '#/components/parameters/term_id'
      - $ref: '#/components/parameters/term_value_id'
      - $ref: '#/components/parameters/without_term_id'
      - $ref: '#/components/parameters/without_term_value_id'
      - $ref: '#/components/parameters/term_id_or_unknown'
      - $ref: '#/components/parameters/annotation_user_id'
      - $ref: '#/components/parameters/acc_above'
      - $ref: '#/components/parameters/acc_below'
      - $ref: '#/components/parameters/acc_below_or_unknown'
      - $ref: '#/components/parameters/d1'
      - $ref: '#/components/parameters/d2'
      - $ref: '#/components/parameters/created_d1'
      - $ref: '#/components/parameters/created_d2'
      - $ref: '#/components/parameters/created_on'
      - $ref: '#/components/parameters/observed_on'
      - $ref: '#/components/parameters/unobserved_by_user_id'
      - $ref: '#/components/parameters/apply_project_rules_for'
      - $ref: '#/components/parameters/cs'
      - $ref: '#/components/parameters/csa'
      - $ref: '#/components/parameters/csi'
      - $ref: '#/components/parameters/geoprivacy'
      - $ref: '#/components/parameters/taxon_geoprivacy'
      - $ref: '#/components/parameters/obscuration'
      - $ref: '#/components/parameters/hrank'
      - $ref: '#/components/parameters/lrank'
      - $ref: '#/components/parameters/iconic_taxa'
      - $ref: '#/components/parameters/id_above'
      - $ref: '#/components/parameters/id_below'
      - $ref: '#/components/parameters/identifications'
      - $ref: '#/components/parameters/lat'
      - $ref: '#/components/parameters/lng'
      - $ref: '#/components/parameters/radius'
      - $ref: '#/components/parameters/nelat'
      - $ref: '#/components/parameters/nelng'
      - $ref: '#/components/parameters/swlat'
      - $ref: '#/components/parameters/swlng'
      - $ref: '#/components/parameters/list_id'
      - $ref: '#/components/parameters/not_in_project'
      - $ref: '#/components/parameters/not_matching_project_rules_for'
      - $ref: '#/components/parameters/observation_accuracy_experiment_id'
      - $ref: '#/components/parameters/fails_dqa_accurate'
      - $ref: '#/components/parameters/fails_dqa_date'
      - $ref: '#/components/parameters/fails_dqa_evidence'
      - $ref: '#/components/parameters/fails_dqa_location'
      - $ref: '#/components/parameters/fails_dqa_needs_id'
      - $ref: '#/components/parameters/fails_dqa_recent'
      - $ref: '#/components/parameters/fails_dqa_subject'
      - $ref: '#/components/parameters/fails_dqa_wild'
      - $ref: '#/components/parameters/q'
      - $ref: '#/components/parameters/search_on'
      - $ref: '#/components/parameters/quality_grade'
      - $ref: '#/components/parameters/updated_since'
      - $ref: '#/components/parameters/viewer_id'
      - $ref: '#/components/parameters/reviewed'
      - $ref: '#/components/parameters/locale'
      - $ref: '#/components/parameters/preferred_place_id'
      - $ref: '#/components/parameters/ttl'
      tags:
      - Observations
      responses:
        '200':
          description: 'Returns an object with metadata and an array of identifiers

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserCountsResponse'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /observations/observers:
    get:
      summary: Observation Observers
      description: 'Given zero to many of following parameters, returns observers of

        observations matching the search criteria and the count of

        observations and distinct taxa of rank `species` they have observed. A

        maximum of 500 results will be returned

        '
      parameters:
      - $ref: '#/components/parameters/acc'
      - $ref: '#/components/parameters/captive'
      - $ref: '#/components/parameters/endemic'
      - $ref: '#/components/parameters/geo'
      - $ref: '#/components/parameters/id_please'
      - $ref: '#/components/parameters/identified'
      - $ref: '#/components/parameters/introduced'
      - $ref: '#/components/parameters/mappable'
      - $ref: '#/components/parameters/native'
      - $ref: '#/components/parameters/out_of_range'
      - $ref: '#/components/parameters/pcid'
      - $ref: '#/components/parameters/photos'
      - $ref: '#/components/parameters/popular'
      - $ref: '#/components/parameters/sounds'
      - $ref: '#/components/parameters/taxon_is_active'
      - $ref: '#/components/parameters/threatened'
      - $ref: '#/components/parameters/verifiable'
      - $ref: '#/components/parameters/licensed'
      - $ref: '#/components/parameters/photo_licensed'
      - $ref: '#/components/parameters/expected_nearby'
      - $ref: '#/components/parameters/id'
      - $ref: '#/components/parameters/not_id'
      - $ref: '#/components/parameters/license'
      - $ref: '#/components/parameters/ofv_datatype'
      - $ref: '#/components/parameters/photo_license'
      - $ref: '#/components/parameters/place_id'
      - $ref: '#/components/parameters/project_id'
      - $ref: '#/components/parameters/rank'
      - $ref: '#/components/parameters/site_id'
      - $ref: '#/components/parameters/sound_license'
      - $ref: '#/components/parameters/taxon_id'
      - $ref: '#/components/parameters/without_taxon_id'
      - $ref: '#/components/parameters/taxon_name'
      - $ref: '#/components/parameters/user_id'
      - $ref: '#/components/parameters/user_login'
      - $ref: '#/components/parameters/ident_user_id'
      - $ref: '#/components/parameters/hour'
      - $ref: '#/components/parameters/day'
      - $ref: '#/components/parameters/month'
      - $ref: '#/components/parameters/year'
      - $ref: '#/components/parameters/created_day'
      - $ref: '#/components/parameters/created_month'
      - $ref: '#/components/parameters/created_year'
      - $ref: '#/components/parameters/term_id'
      - $ref: '#/components/parameters/term_value_id'
      - $ref: '#/components/parameters/without_term_id'
      - $ref: '#/components/parameters/without_term_value_id'
      - $ref: '#/components/parameters/term_id_or_unknown'
      

# --- truncated at 32 KB (92 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/inaturalist/refs/heads/main/openapi/inaturalist-observations-api-openapi.yml