Loading...
Animal Detect logo

Species by ID

Free endpoint
GET /api/v1/species/{id}

Returns species details plus country list where it is available in the model mapping.

Try in Playground

Required Parameters

  • id (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.
Node.js / Express
const speciesId = '3184697f-51ad-4608-9a28-9edb5500159c'

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

const data = await response.json()

Example Response

JSON
{
  "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"]
}