Detect by ID
Free endpointGET /api/v1/detect/{id}Retrieves persisted detect results while available. Pending requests return 202; expired or unknown IDs return 404.
Try in PlaygroundRequired Parameters
id(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.
- Detection results are retained for approximately 30 days.
Node.js / Express
const detectionId = '5e4e5dbd-2604-46b4-bb87-8f42fd682b08'
const response = await fetch(
'https://www.animaldetect.com/api/v1/detect/' + encodeURIComponent(detectionId),
{
headers: {
Authorization: 'Bearer ' + process.env.ANIMAL_DETECT_API_KEY,
},
}
)
const data = await response.json()Example Response
JSON
{
"id": "5e4e5dbd-2604-46b4-bb87-8f42fd682b08",
"status": "success",
"endpoint": "/api/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
}
}