---
title: "Create identification"
method: POST
path: "/insect_id/identification"
tags: ["Insect.id"]
---

# Create identification

`POST /insect_id/identification`

## Request

- Base URL: `https://agents.kindwise.com`
- URL: `https://agents.kindwise.com/insect_id/identification`
- Auth: none required

Send images for identification. See above for description of response and request body.

## Query parameters

- `details` string
- `language` string
- `async` string

## Request body

- object
  - `images` string[]
  - `latitude` number
  - `longitude` number
  - `similar_images` boolean

## Response `201`

Basic / All details / Multilingual details / With suggestion filter / With custom_id / With custom datetime / Async / mutlipart/form-data

- InsectIdIdentification
  - `access_token` string
  - `completed` number, nullable
  - `created` number
  - `custom_id` number, nullable
  - `input` InsectIdInput
    - `datetime` string
    - `images` string[]
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `similar_images` boolean
  - `model_version` string
  - `result` InsectIdResult
    - `classification` object
      - `suggestions` InsectIdSuggestion[]
        - `id` string
        - `name` string
        - `probability` number
        - `similar_images` object[]
          - `id` string
          - `similarity` number
          - `url` string
          - `url_small` string
          - `citation` string
          - `license_name` string
          - `license_url` string
        - `details` union
          - InsectIdDetails
            - `entity_id` string
            - `language` string
            - `gbif_id` number
            - `inaturalist_id` number
            - `rank` string
            - `taxonomy` InsectIdTaxonomy
              - …
            - `common_names` string[], nullable
            - `description` InsectIdValueWithCitation, nullable
              - …
            - `image` InsectIdValueWithCitation, nullable
              - …
            - `images` InsectIdValueWithCitation[]
              - …
            - `danger` string[]
            - `danger_description` string
            - `role` string[]
            - `url` string, nullable
          - InsectIdDetailsMultipleLanguages
    - `is_insect` object
      - `binary` boolean
      - `probability` number
      - `threshold` number
  - `sla_compliant_client` boolean
  - `sla_compliant_system` boolean
  - `status` string

## Other responses

- `401`: error - invalid API key
- `429`: Free daily trial limit reached for this client IP (10 queries / rolling 24 hours). The same status is also returned if the upstream Kindwise API is out of credits.

---

[API](https://skmtc.dev/kindwise/apis/kindwise-agent-trial-proxy.md) · [All operations](https://skmtc.dev/kindwise/apis/kindwise-agent-trial-proxy/llms.txt) · [OpenAPI document](https://skmtc.dev/kindwise/apis/kindwise-agent-trial-proxy/revisions/04259e0cd5e2?raw)