API endpoint update

New integrations should use . Existing URLs remain supported.

Species by ID

Free endpoint
GET/v1/species/{id}

Load one species record, including countries where it is available.

Try in playground

Parameters

Required

uuid

Species identifier from the species list endpoint.

Status codes

200Species record returned.
401Invalid, missing, or revoked API key.
404Species not found.
429Rate limit exceeded.

Examples

Node.js / Express
const speciesId = '3184697f-51ad-4608-9a28-9edb5500159c'

const response = await fetch(
  'https://api.animaldetect.com/v1/species/' + encodeURIComponent(speciesId),
  {
    headers: {
      Authorization: 'Bearer ' + process.env.ANIMAL_DETECT_API_KEY,
    },
  }
)

const data = await response.json()
Example response
{
  "id": "3184697f-51ad-4608-9a28-9edb5500159c",
  "common_name": "fox",
  "scientific_name": "vulpes vulpes",
  "taxonomy": {
    "class": "mammalia",
    "order": "carnivora",
    "family": "canidae",
    "genus": "vulpes",
    "species": "vulpes"
  },
  "countries": ["USA", "CAN", "MEX"]
}