Detect by ID
Free endpointGET
/v1/detect/{id}Fetch a previous detection result by request ID. Use this to check status or reload saved output.
Try in playgroundParameters
Required
uuid
Request ID returned by detection endpoints.
Status codes
200Result found (success or error payload).
202Request still processing.
400Invalid ID format.
401Invalid, missing, or revoked API key.
404Result not found or expired.
429Rate limit exceeded.
Notes
- Detection results expire after 365 days.
Examples
cURL
curl "https://api.animaldetect.com/v1/detect/5e4e5dbd-2604-46b4-bb87-8f42fd682b08" -H "Authorization: Bearer $ANIMAL_DETECT_API_KEY"Python
import os
import requests
detection_id = "5e4e5dbd-2604-46b4-bb87-8f42fd682b08"
response = requests.get(
f"https://api.animaldetect.com/v1/detect/{detection_id}",
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 detectionId = '5e4e5dbd-2604-46b4-bb87-8f42fd682b08'
const response = await fetch(
'https://api.animaldetect.com/v1/detect/' + encodeURIComponent(detectionId),
{
headers: {
Authorization: 'Bearer ' + process.env.ANIMAL_DETECT_API_KEY,
},
}
)
const data = await response.json()Example response
{
"id": "5e4e5dbd-2604-46b4-bb87-8f42fd682b08",
"status": "success",
"endpoint": "/v1/detect",
"created_at": "2026-02-10T09:44:20.954Z",
"completed_at": "2026-02-10T09:44:21.748Z",
"expires_at": "2026-03-12T09:44:20.954Z",
"annotations": [],
"info": {
"processing_time_ms": 794,
"model_version": "v1.0",
"threshold_applied": 0.2
}
}