iNaturalist

iNaturalist Annotations API

Create, delete, and vote

Documentation GitHub OpenAPI

Operations 4

POST /annotations Annotation Create #

DELETE /annotations/{id} Annotation Delete #

POST /votes/vote/annotation/{id} Annotation Vote #

DELETE /votes/unvote/annotation/{id} Annotation Unvote #

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-annotations-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 API
  description: '# https://api.inaturalist.org/v1/


    iNaturalist 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.'
  version: 1.3.0
servers:
- url: /v1
tags:
- name: Annotations
  description: Create, delete, and vote
paths:
  /annotations:
    post:
      summary: Annotation Create
      description: Create an annotation
      tags:
      - Annotations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostAnnotation'
        description: Annotation object
      operationId: postAnnotations
      x-operation-id-source: derived
  /annotations/{id}:
    delete:
      summary: Annotation Delete
      description: Delete an annotation
      parameters:
      - $ref: '#/components/parameters/annotation_path_id'
      tags:
      - Annotations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
      operationId: deleteAnnotationsById
      x-operation-id-source: derived
  /votes/vote/annotation/{id}:
    post:
      summary: Annotation Vote
      description: Vote on an annotation
      parameters:
      - $ref: '#/components/parameters/annotation_path_id'
      tags:
      - Annotations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostVote'
        description: Vote object
      operationId: postVotesVoteAnnotationById
      x-operation-id-source: derived
  /votes/unvote/annotation/{id}:
    delete:
      summary: Annotation Unvote
      description: Remove a vote from annotation
      parameters:
      - $ref: '#/components/parameters/annotation_path_id'
      tags:
      - Annotations
      security:
      - api_token: []
      responses:
        '200':
          description: OK
      operationId: deleteVotesUnvoteAnnotationById
      x-operation-id-source: derived
components:
  parameters:
    annotation_path_id:
      name: id
      in: path
      required: true
      description: ID or UUID of the annotation
      schema:
        type: string
  schemas:
    PostAnnotation:
      type: object
      properties:
        annotation:
          type: object
          properties:
            resource_type:
              type: string
              enum:
              - Observation
            resource_id:
              type: integer
            controlled_attribute_id:
              type: integer
            controlled_value_id:
              type: integer
    PostVote:
      type: object
      properties:
        vote:
          type: string
          enum:
          - up
          - down
  securitySchemes:
    api_token:
      type: apiKey
      name: Authorization
      in: header