Loading...
Animal Detect logo

API endpoint update

New integrations should use . Existing URLs will keep working for the next few months while teams migrate.

Species by ID

Free endpoint
GET /v1/species/{id}

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

Try in Playground

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

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.