DEV Community

Cover image for Understanding FaceIO REST API – Face Verify & Age Check
Vincent
Vincent

Posted on

Understanding FaceIO REST API – Face Verify & Age Check

In this article we’ll dive into FACEIO’s REST API, specifically the faceverify and agecheck endpoints. These APIs allow you to perform biometric login, age verification, and liveness detection without relying on traditional password-based flows.

FACEIO Flow


Why BASE64 Encoding Matters

Both faceverify and agecheck endpoints require you to transmit images in BASE64 format. BASE64 encoding ensures that binary data such as PNG or JPEG images can be safely transported in JSON payloads over HTTPS.

This design makes integration simpler across multiple environments (web, mobile, backend) without worrying about multipart uploads or binary transfer issues.


How Face Verify Works

The Face Verify API compares two images to check if they belong to the same person.

You supply:

  • src: BASE64-encoded image of the first face (e.g., from an ID or enrollment)
  • target: BASE64-encoded image of the face to compare against

Common Use Cases

  • Matching a live selfie against a document photo
  • Preventing duplicate registrations in your system
  • Enabling secure passwordless logins

How Age Check Works

The Age Check API estimates the age and gender of the person from a single image. Just provide one BASE64-encoded photo of the face, and the service responds with an age estimate and gender classification.

Common Use Cases

  • Age-restricted services (gambling, alcohol, adult content)
  • KYC (Know Your Customer) compliance checks
  • Content or feature gating based on age

Security & Privacy

One of FACEIO’s strongest advantages is its privacy-first design:

  • All processing happens in memory (RAM).
  • Images are purged immediately after verification or analysis.
  • No storage, no logs, no lingering biometric data.

For more details, check the Security Best Practices and Privacy Best Practices.


Developer Resources


Final Thoughts

The FACEIO REST API provides developers with powerful tools for face verification and age detection, enabling passwordless logins, compliance workflows, and liveness protection.

By relying on BASE64-encoded images, HTTPS transport, and in-memory processing, FACEIO delivers a secure and privacy-respecting foundation for modern biometric applications.

If you’re building authentication, KYC, or age-gated experiences, FACEIO’s REST API offers a lightweight yet robust solution that outperforms legacy alternatives.

Top comments (0)