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

x-api-key · string · required

API key used to authenticate the request.

---

Body

faceImageBase64 · string · required

Base64-encoded face image used for age estimation.

faceImageFileName · string

Original filename of the uploaded image.

faceImageBytes · string

Raw image bytes (optional alternative to Base64 input).

---

Response

200

success · boolean

Indicates whether the request was processed successfully.

requestId · string

Unique identifier for the API request.

correlationId · string

Identifier used for tracing the request across systems.

data · object

Contains age estimation and face analysis results.

data.status · string

Overall decision status (e.g., Approved, Rejected).

data.estimatedAge · number

Predicted age of the individual.

data.confidenceScore · number

Confidence score of the age estimation.

data.gender · string

Detected gender of the individual.

data.faceQuality · number

Quality score of the detected face image.

data.faceLuminance · number

Luminance/brightness score of the face image.

data.isApproved · boolean

Indicates whether the result meets approval criteria.

error · object | null

Contains error details if the request fails; otherwise null.

durationMs · number

Time taken to process the request in milliseconds.

processedAt · string

Timestamp when the request was processed (ISO 8601 format).

400

error · string

Error message describing why the request failed.

code · string

Machine-readable error code for debugging.

---

Curl

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": "<base64-face>",
    "faceImageFileName": "selfie.jpg"
  }'

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": "<base64-face>",
    "faceImageFileName": "selfie.jpg"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

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: "<base64-face>",
    faceImageFileName: "selfie.jpg"
  })
})
.then(res => res.json())
.then(console.log);

<?php
$url = "https://dev-idf-gw.cognetlabs.org/api/gw/services/age-estimation";

$data = [
  "faceImageBase64" => "<base64-face>",
  "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;
?>

package main

import (
	"bytes"
	"net/http"
)

func main() {
	jsonData := []byte(`{
		"faceImageBase64":"<base64-face>"
	}`)

	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)
}

import okhttp3.*;

public class Main {
    public static void main(String[] args) throws Exception {

        OkHttpClient client = new OkHttpClient();

        String json = "{\"faceImageBase64\":\"<base64-face>\", \"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());
    }
}

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: "<base64-face>",
  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

200

{
"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"
}

{
  "error": "FaceImageBase64 is required"
}