Our Age Estimation process provides comprehensive insights into the verification process, helping you understand the age assessment and potential risks associated with each verification attempt.
Report Structure
The age estimation report is returned as a JSON object containing a liveness object.
Core Response Fields
interface LivenessVerificationResponse {
liveness: {
status: 'Approved' | 'Declined' | 'In Review' | 'Not Finished';
method: 'ACTIVE_3D' | 'FLASHING' | 'PASSIVE';
score: number;
reference_image: string; // Temporary URL
video_url: string | null; // Temporary URL
age_estimation: number | null; // Age estimation in years for the target image
warnings: {
risk: string;
additional_data: string | null;
log_type: 'information' | 'warning' | 'error';
short_description: string;
long_description: string;
}[];
}
}Sample JSON Response
{
"liveness": {
"status": "Approved",
"method": "ACTIVE_3D",
"score": 89.92,
"reference_image": "https://example.com/reference.jpg",
"video_url": "https://example.com/video.mp4",
"age_estimation": 24.3,
"warnings": [
{
"risk": "LOW_LIVENESS_SCORE",
"additional_data": null,
"log_type": "information",
"short_description": "Low liveness score",
"long_description": "The liveness check resulted in a low score, indicating potential use of non-live facial representations or poor-quality biometric data."
}
],
}
}For more information about potential warnings during the age estimation process, check our Age Estimation Warnings guide.
Security Note
The URLs provided for age estimation images and videos are temporary and expire after 60 minutes for enhanced security. Ensure these media resources are handled with appropriate security measures and are not shared publicly. As a best practice, your application should only store the verification status and confidence score, minimizing the amount of biometric data retained on your servers.