---
title: "Read your photo suggestion."
method: GET
path: "/recognitions/{id}"
tags: ["Recognition"]
---

# Read your photo suggestion.

`GET /recognitions/{id}`

## Request

- Base URL: `https://animalchecklist.com/api/v1`
- URL: `https://animalchecklist.com/api/v1/recognitions/{id}`
- Auth: API key in cookie `ac_session`

Returns the current status of a recognition job owned by this account. Jobs can include up to three species choices. Missing species require explicit confirmation before catalog import. Quality, accepted taxonomy, licensed photos, and specialist agreement govern import eligibility. A family alone cannot be confirmed. Jobs expire after 24 hours.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `lang` 'en' | 'de' | 'es' | 'fr' | 'it' | 'nl' | 'pt' | 'pl': Display language of `name`, category labels and the summary. Falls back to `en`.

## Headers

- `X-Account-Id` string, uuid, required

## Response `200`

Current job status. Private and not cached.

- object
  - `data` object, required
    - `id` string, uuid, required
    - `status` 'pending' | 'matched' | 'no_match' | 'failed', required
    - `animal` AnimalSummary: Card-sized animal taxon used by list and search answers.
      - `id` string, required: Slug of the animal taxon, for example `red-fox`.
      - `name` string, required: Name in the requested language, English when none exists.
      - `nameEn` string, required: English common name.
      - `nameSci` string, required: Scientific name.
      - `taxonRank` string: Taxonomic rank. Legacy records default to species.
      - `parentNameSci` string, nullable: Parent species scientific name for a subspecies. Null for species.
      - `categoryId` 'mammals' | 'birds' | 'reptiles' | 'amphibians' | 'fish' | 'insects' | 'other', required
      - `habitats` string[], required
      - `tickable` boolean: Whether a new checklist sighting is allowed.
      - `sourceUrl` string, uri
      - `image` object, nullable, required
        - `url` string, uri, required
    - `family` object
      - `rank` 'family', required
      - `nameSci` string, required: Animal family name validated against the GBIF Backbone Taxonomy.
    - `uncertainty` 'low_quality' | 'specialist_disagrees': Low detail prevents a definite family result.
    - `candidates` object[]
      - `id` string, uuid, required
      - `nameSci` string, required
      - `nameEn` string, required
      - `nameDe` string, required
      - `categoryId` string, required
      - `familySci` string
      - `animal` AnimalSummary: Card-sized animal taxon used by list and search answers.
        - `id` string, required: Slug of the animal taxon, for example `red-fox`.
        - `name` string, required: Name in the requested language, English when none exists.
        - `nameEn` string, required: English common name.
        - `nameSci` string, required: Scientific name.
        - `taxonRank` string: Taxonomic rank. Legacy records default to species.
        - `parentNameSci` string, nullable: Parent species scientific name for a subspecies. Null for species.
        - `categoryId` 'mammals' | 'birds' | 'reptiles' | 'amphibians' | 'fish' | 'insects' | 'other', required
        - `habitats` string[], required
        - `tickable` boolean: Whether a new checklist sighting is allowed.
        - `sourceUrl` string, uri
        - `image` object, nullable, required
          - `url` string, uri, required
      - `canConfirm` boolean, required
      - `reason` 'uncertain' | 'image_unavailable' | 'specialist_disagrees' | 'taxonomy_unavailable' | 'verification_unavailable'
    - `breedHints` object[]: Possible domestic dog or cat breed appearance, matched to a sourced registry. A photo cannot confirm pedigree. Hints do not create catalog animals or rewards.
      - `id` string, required
      - `name` string, required
      - `parentNameSci` 'Canis familiaris' | 'Felis catus', required
      - `sourceUrl` string, uri, required
      - `registry` 'FCI' | 'FIFe' | 'CFA', required
      - `status` 'recognized' | 'provisional', required
    - `excludedIds` string[], required
    - `visibleFeatures` string[]

## Other responses

- `400`: Invalid input.
- `401`: Sign-in required.
- `403`: A same-origin request is required.
- `404`: Not found.
- `409`: Account changed in another tab.
- `429`: Rate limited.
- `500`: Unexpected error.

---

[API](https://skmtc.dev/animalchecklist/apis/animal-checklist-api.md) · [All operations](https://skmtc.dev/animalchecklist/apis/animal-checklist-api/llms.txt) · [OpenAPI document](https://skmtc.dev/animalchecklist/apis/animal-checklist-api/revisions/0910760ad25b?raw)