Detect by ID
Free endpointGET /api/v1/detect/{id}Use this endpoint to fetch a previous detection result by request ID so your app can check status or load saved output.
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
}
}