Species by ID
Free endpointGET
/v1/species/{id}Load one species record, including countries where it is available.
Try in playgroundParameters
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
cURL
curl "https://api.animaldetect.com/v1/species/3184697f-51ad-4608-9a28-9edb5500159c" -H "Authorization: Bearer $ANIMAL_DETECT_API_KEY"Python
import os
import requests
response = requests.get(
"https://api.animaldetect.com/v1/species/3184697f-51ad-4608-9a28-9edb5500159c",
headers={
"Authorization": "Bearer " + os.environ["ANIMAL_DETECT_API_KEY"],
"User-Agent": "MyApp/1.0 (ops@example.com)",
},
)
response.raise_for_status()
data = response.json()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"]
}