• Introduction
• Use cases
• Endpoints
• Schemas
• Integration guidelines
• Samples
• Contacts

YouAge API

Welcome to YouAge API, part of the Youverse Services suite.

The YouAge API provides facial age estimation — determining a person’s apparent age directly from a face image.

It enables automated age verification for digital onboarding, gaming, retail, and compliance workflows.

By leveraging advanced deep learning models trained on diverse demographic datasets, YouAge ensures reliable, unbiased, and accurate predictions across global populations.

The API operates via a single REST endpoint that accepts an image in Base64 format and returns an estimated age with an image validation status.

Use Cases

Digital Onboarding & KYC

Integrate YouAge into identity verification flows to estimate a user’s age before proceeding with full identity checks.

It streamlines onboarding by automatically filtering underage users and ensures compliance with KYC and AML regulations.

Gaming & Entertainment

YouAge helps enforce age restrictions in gaming and streaming services by automatically determining whether users meet minimum age requirements.
This supports COPPA, GDPR-K, and similar youth-protection laws worldwide.

E-commerce & Alcohol Delivery

E-commerce and delivery platforms can use YouAge to pre-screen users purchasing age-restricted goods (alcohol, tobacco, or adult products), reducing manual verification steps and ensuring compliance.

Parental Control Systems

Integrate YouAge in parental-control platforms to dynamically adjust content access based on real-time age estimation.

Public Terminals & Smart Kiosks

Smart vending or self-service kiosks can use YouAge to verify age eligibility instantly before granting access to restricted goods or services.

Endpoints

Age Estimation

Performs facial age estimation from a single Base64 image.

POST | {base_url}/age

Accepts: Process request

Success

Error responses

Schemas

Process Request

Request processing of an image in base64 and the age configurations.

{
    "image": "string",
    "configuration": [configA, configB]
}

Properties

Process request config

Extensible configurations for biometric processing.

{
    "name": "string",
    "value": "string"
}

Enumerable types

Process Response

Response returned after successful age estimation.

{
  "age": 31.04,
  "status": "VALID_IMAGE"
}

Properties

Enumerable types

Error Response

{
  "status_code": 400,
  "phrase": "string",
  "message": "string"
}

Integration Guidelines

The YouAge API should be integrated in a secure backend environment.

All requests must include an x-api-key, ensuring that sensitive biometric data and credentials remain protected.

Recommended Flow

primary Frontend Capture

Capture the user’s selfie using the official Youverse WebComponent or your own frontend implementation.

Send the Base64-encoded image securely to your backend.

primary Backend Processing

Your backend calls the YouAge API using the private x-api-key, receives the age estimation response, and forwards only the result to your frontend.

primary Decision Logic

Use the estimated age to control access (e.g., allow if over 18), or flag for further verification.

Samples

Python

import requests
import base64

base_url = "https://face-analysis.youverse.id/v1"
url = f"{base_url}/age"

# Encode image
with open("selfie.jpg", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode("utf-8")

headers = {
    "x-api-key": "YOUR_API_KEY"
}

payload = {
    "image": image_b64
}

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

Node.js

import axios from "axios";
import fs from "fs";

const baseURL = "https://face-analysis.youverse.id/v1";
const url = `${baseURL}/age`;

// Read and encode image as base64
const imageBuffer = fs.readFileSync("selfie.jpg");
const imageBase64 = imageBuffer.toString("base64");

const payload = {
  image: imageBase64
};

axios.post(url, payload, {
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY"
  }
})
  .then(response => console.log(response.data))
  .catch(error => console.error("Error:", error.response?.data || error.message));

OpenAPI Specification

The following OpenAPI 3.0 YAML defines the YouAge API endpoint and response schema.
You can import it directly into tools like Swagger UI, Postman, or Insomnia.

Contacts

Please check our GitHub space for integration SDKs.

We are working to expand our SDK offerings.
If you’d like to contribute or request new SDKs, please contact us.