iNaturalist

iNaturalist UTFGrid API

JSON for observation tiles

GitHub OpenAPI

Operations 4

GET /colored_heatmap/{zoom}/{x}/{y}.grid.json Colored Heatmap Tiles UTFGrid
GET /grid/{zoom}/{x}/{y}.grid.json Grid Tiles UTFGrid
GET /heatmap/{zoom}/{x}/{y}.grid.json Heatmap Tiles UTFGrid
GET /points/{zoom}/{x}/{y}.grid.json Points Tiles UTFGrid

Documentation

📖
Documentation
https://www.inaturalist.org/pages/api+reference
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/inaturalist/main/rate-limits/rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/inaturalist/refs/heads/main/openapi/inaturalist-utfgrid-api-openapi.yml

Other Resources

🔗
PostmanCollection
https://www.postman.com/collections/inaturalist-api
🔗
Plans
https://raw.githubusercontent.com/api-evangelist/inaturalist/main/plans/plans.yml
🔗
FinOps
https://raw.githubusercontent.com/api-evangelist/inaturalist/main/finops/finops.yml

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-utfgrid-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

inaturalist-utfgrid-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: iNaturalist Annotations UTF Grid 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: UTFGrid
  description: JSON for observation tiles
paths:
  /colored_heatmap/{zoom}/{x}/{y}.grid.json:
    get:
      summary: Colored Heatmap Tiles UTFGrid
      description: 'Given zero to many of following parameters, returns a JSON file

        following the UTFGrid spec, representing observations matching

        the search criteria

        '
      parameters:
      - $ref: '#/components/parameters/zoom'
      - $ref: '#/components/parameters/x'
      - $ref: '#/components/parameters/y'
      - $ref: '#/components/parameters/tile_color'
      - $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'
      tags:
      - UTFGrid
      responses:
        '200':
          description: 'Returns a UTFGrid

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UTFGridResponse'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /grid/{zoom}/{x}/{y}.grid.json:
    get:
      summary: Grid Tiles UTFGrid
      description: 'Given zero to many of following parameters, returns a JSON file

        following the UTFGrid spec, representing observations matching

        the search criteria

        '
      parameters:
      - $ref: '#/components/parameters/zoom'
      - $ref: '#/components/parameters/x'
      - $ref: '#/components/parameters/y'
      - $ref: '#/components/parameters/tile_color'
      - $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'
      tags:
      - UTFGrid
      responses:
        '200':
          description: 'Returns a UTFGrid

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UTFGridResponse'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /heatmap/{zoom}/{x}/{y}.grid.json:
    get:
      summary: Heatmap Tiles UTFGrid
      description: 'Given zero to many of following parameters, returns a JSON file

        following the UTFGrid spec, representing observations matching

        the search criteria

        '
      parameters:
      - $ref: '#/components/parameters/zoom'
      - $ref: '#/components/parameters/x'
      - $ref: '#/components/parameters/y'
      - $ref: '#/components/parameters/tile_color'
      - $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'
      tags:
      - UTFGrid
      responses:
        '200':
          description: 'Returns a UTFGrid

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UTFGridResponse'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /points/{zoom}/{x}/{y}.grid.json:
    get:
      summary: Points Tiles UTFGrid
      description: 'Given zero to many of following parameters, returns a JSON file

        following the UTFGrid spec, representing observations matching

        the search criteria

        '
      parameters:
      - $ref: '#/components/parameters/zoom'
      - $ref: '#/components/parameters/x'
      - $ref: '#/components/parameters/y'
      - $ref: '#/components/parameters/tile_color'
      - $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'
      tags:
      - UTFGrid
      responses:
        '200':
          description: 'Returns a UTFGrid

            '
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UTFGridResponse'
        default:
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  parameters:
    photos:
      name: photos
      in: query
      description: Observations with photos
      schema:
        type: boolean
    nelng:
      name: nelng
      in: query
      description: 'Must be within this bounding box (*nelat, *nelng, *swlat, *swlng)

        '
      schema:
        type: number
        format: double
    ident_user_id:
      name: ident_user_id
      in: query
      description: Observations identified by a particular user
      schema:
        type: integer
    photo_licensed:
      name: photo_licensed
      in: query
      description: License attribute of at least one photo of an observation must not be null
      schema:
        type: boolean
    sound_license:
      name: sound_license
      in: query
      description: Must have at least one sound with this license
      schema:
        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
    ofv_datatype:
      name: ofv_datatype
      in: query
      description: Must have an observation field value with this datatype
      schema:
        type: array
        items:
          type: string
        maximum: 31
        minimum: 1
    lng:
      name: lng
      in: query
      description: 'Must be within a {`radius`} kilometer circle around this lat/lng

        (*lat, *lng, radius)

        '
      schema:
        type: number
        format: double
    pcid:
      name: pcid
      in: query
      description: 'Observations 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)

        '
      schema:
        type: boolean
    observed_on:
      name: observed_on
      in: query
      description: Must be observed on this date
      schema:
        type: string
        format: date
    photo_license:
      name: photo_license
      in: query
      description: Must have at least one photo with this license
      schema:
        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
    acc_below_or_unknown:
      name: acc_below_or_unknown
      in: query
      description: Positional accuracy must be below this value (in meters) or be unknown
      schema:
        type: string
    apply_project_rules_for:
      name: apply_project_rules_for
      in: query
      description: Must match the rules of the project with this ID or slug
      schema:
        type: string
    fails_dqa_wild:
      name: fails_dqa_wild
      in: query
      description: Must be voted as not wild
      schema:
        type: boolean
    license:
      name: license
      in: query
      description: Observation must have this license
      schema:
        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
    out_of_range:
      name: out_of_range
      in: query
      description: Observations whose taxa are outside their known ranges
      schema:
        type: boolean
    not_in_project:
      name: not_in_project
      in: query
      description: Must not be in the project with this ID or slug
      schema:
        type: string
    obscuration:
      name: obscuration
      in: query
      description: 'Must have `geoprivacy` or `taxon_geoprivacy` fields matching these values

        '
      schema:
        type: array
        items:
          type: string
        enum:
        - obscured
        - private
        - none
    swlng:
      name: swlng
      in: query
      description: 'Must be within this bounding box (*nelat, *nelng, *swlat, *swlng)

        '
      schema:
        type: number
        format: double
    term_id:
      name: term_id
      in: query
      description: Must have an annotation using this controlled term ID
      schema:
        type: array
        items:
          type: integer
    swlat:
      name: swlat
      in: query
      description: 'Must be within this bounding box (*nelat, *nelng, *swlat, *swlng)

        '
      schema:
        type: number
        format: double
    csi:
      name: csi
      in: query
      description: 'Taxon must have this IUCN conservation status. If

        the `place_id` parameter is also specified, this will only consider

        statuses specific to that place

        '
      schema:
        type: array
        items:
          type: string
        enum:
        - LC
 

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