> ## Documentation Index
> Fetch the complete documentation index at: https://venator-06aff335.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Age Estimation
Estimate a person’s age from a face image using AI-based facial analysis.\
This service analyzes facial features and returns an approximate age range or numeric age estimate for identity verification, fraud detection, and age-restricted access control.
POST
/api/gw/services/age\_estimation
***
### Authorizations
API key used to authenticate the request.
***
### Body
Base64-encoded face image used for age estimation.
Original filename of the uploaded image.
Raw image bytes (optional alternative to Base64 input).
***
### Response
Indicates whether the request was processed successfully.
Unique identifier for the API request.
Identifier used for tracing the request across systems.
Contains age estimation and face analysis results.
Overall decision status (e.g., Approved, Rejected).
Predicted age of the individual.
Confidence score of the age estimation.
Detected gender of the individual.
Quality score of the detected face image.
Luminance/brightness score of the face image.
Indicates whether the result meets approval criteria.
Contains error details if the request fails; otherwise null.
Time taken to process the request in milliseconds.
Timestamp when the request was processed (ISO 8601 format).
Error message describing why the request failed.
Machine-readable error code for debugging.
***
```bash Curl theme={null}
curl -X POST "https://dev-idf-gw.cognetlabs.org/api/gw/services/age-estimation" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"faceImageBase64": "",
"faceImageFileName": "selfie.jpg"
}'
```
```python Python theme={null}
import requests
url = "https://dev-idf-gw.cognetlabs.org/api/gw/services/age-estimation"
headers = {
"Content-Type": "application/json",
"x-api-key": "YOUR_API_KEY"
}
payload = {
"faceImageBase64": "",
"faceImageFileName": "selfie.jpg"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
```
```javascript JavaScript theme={null}
fetch("https://dev-idf-gw.cognetlabs.org/api/gw/services/age-estimation", {
method: "POST",
headers: {
"Content-Type": "application/json",
"x-api-key": "YOUR_API_KEY"
},
body: JSON.stringify({
faceImageBase64: "",
faceImageFileName: "selfie.jpg"
})
})
.then(res => res.json())
.then(console.log);
```
```php PHP theme={null}
"",
"faceImageFileName" => "selfie.jpg"
];
$options = [
"http" => [
"header" => "Content-Type: application/json\r\nx-api-key: YOUR_API_KEY",
"method" => "POST",
"content" => json_encode($data),
],
];
$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
echo $result;
?>
```
```go Go theme={null}
package main
import (
"bytes"
"net/http"
)
func main() {
jsonData := []byte(`{
"faceImageBase64":""
}`)
req, _ := http.NewRequest("POST",
"https://dev-idf-gw.cognetlabs.org/api/gw/services/age-estimation",
bytes.NewBuffer(jsonData),
)
req.Header.Set("Content-Type", "application/json")
req.Header.Set("x-api-key", "YOUR_API_KEY")
client := &http.Client{}
client.Do(req)
}
```
```java Java theme={null}
import okhttp3.*;
public class Main {
public static void main(String[] args) throws Exception {
OkHttpClient client = new OkHttpClient();
String json = "{\"faceImageBase64\":\"\", \"faceImageFileName\":\"selfie.jpg\" }";
RequestBody body = RequestBody.create(
json, MediaType.parse("application/json")
);
Request request = new Request.Builder()
.url("https://dev-idf-gw.cognetlabs.org/api/gw/services/age-estimation")
.addHeader("x-api-key", "YOUR_API_KEY")
.post(body)
.build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());
}
}
```
```ruby Ruby theme={null}
require 'net/http'
require 'uri'
require 'json'
uri = URI.parse("https://dev-idf-gw.cognetlabs.org/api/gw/services/age-estimation")
header = {
'Content-Type': 'application/json',
'x-api-key': 'YOUR_API_KEY'
}
payload = {
faceImageBase64: "",
faceImageFileName: "selfie.jpg"
}
http = Net::HTTP.new(uri.host, uri.port)
request = Net::HTTP::Post.new(uri.request_uri, header)
request.body = payload.to_json
response = http.request(request)
puts response.body
```
```json 200 theme={null}
{
"success":true,
"requestId":"ddf222a706d3",
"correlationId":"corr-1777470099227",
"data":{
"status":"Approved",
"estimatedAge":26.5,
"confidenceScore":77.87,
"gender":"male",
"faceQuality":2522.575892886491,
"faceLuminance":2798.226405264767,
"isApproved":true
},
"error":null,
"durationMs":2360,
"processedAt":"2026-04-29T13:41:41.9113966Z"
}
```
```json 400 theme={null}
{
"error": "FaceImageBase64 is required"
}
```