Recognition

Read your photo suggestion.

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.

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

Path parameters

idstring uuid required

Job id returned by POST /recognitions.

Query parameters

lang'en' | 'de' | 'es' | 'fr' | 'it' | 'nl' | 'pt' | 'pl'

Display language of name, category labels and the summary. Falls back to en.

Display language. Default en.

Headers

X-Account-Idstring uuid required

Account id shown by GET /account. Prevents a browser session change from changing a different account.

Response

Current job status. Private and not cached.

Example response

{
  "data": {
    "animal": {
      "id": "red-fox",
      "nameSci": "Vulpes vulpes"
    },
    "family": {
      "nameSci": "Theraphosidae"
    },
    "candidates": [
      {
        "animal": {
          "id": "red-fox",
          "nameSci": "Vulpes vulpes"
        }
      }
    ],
    "excludedIds": [
      "red-fox"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.