Skip to main content
POST
Detect Face
Submit a single image. If a face is present, the response includes its bounding box, key facial landmarks, and a normalized confidence score. Use this endpoint when you need to confirm a usable face image before sending it to /v1/face/compare or /v1/face/estimate-age — for example, to give the user immediate feedback that their selfie is too dark or off-frame.

Request

Headers

Body parameters

See the overview for the shared image rules.

Example request

Response

200 — Success

boundingBox shape: { top, left, width, height }, each normalized to 0–1 against the source image dimensions. landmarks[] shape: { type, x, y }, where type is the landmark name (e.g. eyeLeft, nose, mouthRight) and x/y are normalized to the image dimensions.

Error responses

When no face is detected the endpoint still returns 200 OK with faceDetected: false. Treat that as a UX-level failure (prompt the user to retake) rather than an integration error. Only the highest-confidence face is returned.