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 PlaygroundExamples
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
}
}Parameters
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 30 days.