Check face photos before payment or analysis

Available to authenticated mobile, widget and dashboard callers. Runs the same two
checks POST /skin/analyze runs on a face set — the image-quality gate (lighting,
blur, distance, obstructions, glasses, filters) and the pose check (one front, one
left, one right view) — without generating a scan, allocating a payment, consuming
scan credits, or storing the photos.

Call it as soon as the three face photos are saved, and keep the customer on photo
review while it runs. On 422, show issues and offer a retake; nothing has started.
Any other failure (429, 5xx, network) means the check could not answer: let the
customer continue, because POST /skin/analyze still checks photos it has not seen
pass.

A passing set is remembered for one hour against each photo's bytes. When
POST /skin/analyze receives those exact files it skips the image-quality gate, and
the pose check reuses this request's FaceMesh answer instead of asking again, so a
set is checked once. A retake is a new file and is checked in full. Send the same
bytes to both endpoints: re-encoding a photo between the two makes it a new file.
Limited to 30 requests per minute per authenticated caller and IP address.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
images
array of objects
required
length between 3 and 3

Exactly three photos, one per view.

images*
file
required

JPEG, PNG, WebP or HEIC/HEIF, up to 12 MB.

string
required
length ≤ 100

The view the photo was taken as — front, left or right. Used
as the fallback side when a side profile cannot be classified, and
to name the photo in any rejection issue.

file
required

JPEG, PNG, WebP or HEIC/HEIF, up to 12 MB.

string
required
length ≤ 100

The view the photo was taken as — front, left or right. Used
as the fallback side when a side profile cannot be classified, and
to name the photo in any rejection issue.

file
required

JPEG, PNG, WebP or HEIC/HEIF, up to 12 MB.

string
required
length ≤ 100

The view the photo was taken as — front, left or right. Used
as the fallback side when a side profile cannot be classified, and
to name the photo in any rejection issue.

Responses

401

Authentication required.

429

Quality-check request limit exceeded. The scan still checks the photos on submit.

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json