---
title: "Retrieve identification"
method: GET
path: "/mushroom_id/identification/{access_token}"
tags: ["Mushroom.id"]
---

# Retrieve identification

`GET /mushroom_id/identification/{access_token}`

## Request

- Base URL: `https://agents.kindwise.com`
- URL: `https://agents.kindwise.com/mushroom_id/identification/{access_token}`
- Auth: none required

Can be used to

- retrieve identification result when identification is created with `async=True`
- retrieve past identifications (available for 6 months)
- retrieve identification results with different details or languages

## Query parameters

- `details` string
- `language` string

## Response `200`

Basic / With custom_id

- MushroomIdIdentification
  - `access_token` string
  - `completed` number, nullable
  - `created` number
  - `custom_id` number, nullable
  - `input` MushroomIdInput
    - `datetime` string
    - `images` string[]
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `similar_images` boolean
  - `model_version` string
  - `result` MushroomIdResult
    - `classification` object
      - `suggestions` MushroomIdSuggestion[]
        - `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
          - MushroomIdDetails
            - `entity_id` string
            - `language` string
            - `gbif_id` number
            - `inaturalist_id` number
            - `rank` string
            - `taxonomy` MushroomIdTaxonomy
              - …
            - `common_names` string[], nullable
            - `description` MushroomIdValueWithCitation, nullable
              - …
            - `image` MushroomIdValueWithCitation, nullable
              - …
            - `images` MushroomIdValueWithCitation[]
              - …
            - `url` string, nullable
            - `edibility` string, nullable
            - `characteristic` MushroomIdCharacteristic
              - …
            - `synonyms` string[], nullable
            - `look_alike` MushroomIdLookAlike[], nullable
              - …
            - `psychoactive` boolean, nullable
            - `thumbnail` MushroomIdValueWithCitation, nullable
              - …
          - MushroomIdDetailsMultipleLanguages
    - `is_mushroom` object
      - `binary` boolean
      - `probability` number
      - `threshold` number
  - `sla_compliant_client` boolean
  - `sla_compliant_system` boolean
  - `status` string

## Other responses

- `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)