Face API

Face Detection API

Detect faces in an image with position and quality signals.

Get API key Talk to sales

REST + JSONOne API keyPay per callHTTPS secured

POST/v1/face-detectionready

Request

Response{  "error": false,  "status": "SUCCESS",  "data": {    "match_score": "…",    "liveness_result": "…",    "face_detection_data": "…"  }}

Illustrative example. Exact parameters are listed in your dashboard docs.

How it works

What you send and what you get back

Add biometric assurance to digital KYC: match selfies to ID photos, detect liveness and spoofing, and capture quality selfies in your app.

You send

Selfie image
ID photo for matching

You get back

Match score
Liveness result
Face detection data

Why Shadoweye

Built for production from day one

Real-time results

Responses come back in milliseconds, so the check fits inline in your signup or approval flow.

Clean, consistent JSON

Every Shadoweye API returns the same response envelope. Parse it once and reuse it everywhere.

One key for every API

Use the same API key for the Face Detection API and every other API in the catalogue. No extra contracts.

Pay per call

Calls are charged from your prepaid wallet. No monthly fee and no minimum commitment.

Secure by default

All traffic runs over HTTPS and every request is authenticated with your secret key.

Full audit trail

Every call and deduction is recorded in your dashboard ledger for reconciliation and audits.

Use cases

Where teams use the Face Detection API

Video & digital KYC

Confirm the person matches their ID.

Account recovery

Re-verify users with a selfie.

Fraud prevention

Block photo, screen and mask spoofs.

Attendance

Verify field staff with face checks.

Get started

Go live in four steps

Create your account

Add funds

Top up your prepaid wallet securely with UPI, card or net banking.

Test it live

Try the Face Detection API with real data in the Live Tester before you write code.

Call the API

Send a POST request with your key in the X-Shadoweye-Api-Key header and use the JSON response.

FAQ

Frequently asked questions

What is the Face Detection API?

Detect faces in an image with position and quality signals. It is part of the Shadoweye Face API family and is available through a single REST API key.

What do I need to send to the Face Detection API?

Typical inputs are: Selfie image; ID photo for matching. The exact parameters for this API are listed in your dashboard documentation.

What does the Face Detection API return?

You receive a JSON response that typically includes: Match score; Liveness result; Face detection data.

How much does the Face Detection API cost?

Calls are charged per request from your prepaid Shadoweye wallet at the rate shown in your dashboard. There are no monthly fees or minimum commitments.

How do I get started?

Create a free account, add funds to your wallet, copy your API key and test the API in the Live Tester. Most teams go live the same day.

Is my data secure?

All requests use HTTPS, are authenticated with your secret API key and are recorded in your audit ledger. Only send personal data you are permitted to process, with the customer's consent where required.

Related Face API

View all