Skip to main content
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.