Selfie Age Estimation

AgeMatch 5.0 Estimate API

The AgeMatch 5.0 Estimate API provides an estimate of the age based on a provided selfie.

POST /process/comprehensive/gateway

Submits a request to estimate the age of a person based on a selfie image.

Request

FieldTypeDescriptionRequired

user

string

Your Veratad username

Yes

pass

string

Your Veratad password

Yes

service

string

The service identifier

Yes

reference

string

A unique reference for the transaction

No

rules

string

Additional rules for the transaction

No

target

object

The target information

Yes

Target Object

FieldTypeDescriptionRequired

selfie

string

Base64 encoded face image

Yes

age

string

The age to check against

Yes

Example Request

{
  "user": "username",
  "pass": "password",
  "service": "AgeMatch5.0.Estimate",
  "reference": "12345",
  "rules": "",
  "target": {
    "selfie": "base 64 encoded face image",
    "age": "21+"
  }
}

Response

The response will contain metadata about the request, output details, and the result of the age estimation.

Response Object

FieldTypeDescription

meta

object

Contains metadata related to the transaction

output

object

Contains the output of the age estimate

result

object

Contains the result of the age verification

Meta Object

FieldTypeDescription

confirmation

number

Confirmation number for the request

timestamp

string

Timestamp of the transaction

reference

string

Reference of the original request

user

string

Your Veratad username

company

string

Your company name

service

string

The service identifier

Selfie Object

FieldTypeDescription

age_estimate

string

Estimated age range

Result Object

FieldTypeDescription

action

string

The action taken, either PASS or FAIL

detail

string

Details of the action

issues

array

An array of issues if any

Example Response

{
  "meta": {
    "confirmation": 160567642,
    "timestamp": "2023-11-07 13:23:55",
    "reference": "12345",
    "user": "root@veratad.com",
    "company": "Veratad Technologies, LLC",
    "service": "AgeMatch5.0.Estimate.ROC"
  },
  "output": {
    "images": {
      "selfie": {
        "age_estimate": "27-31"
      }
    }
  },
  "result": {
    "action": "PASS",
    "detail": "ALL CHECKS PASSED",
    "issues": []
  }
}

Last updated