FaceVerify API
A hosted face verification API. Your backend starts a verification session, then the person completes a guided live capture in the browser before the session is confirmed.
How it works
- Your backend calls
POST /v1/verifywith an external user ID, optional display name, redirect URL, and metadata. - The response always includes a
verify_url. Send the user there to begin the camera flow. - The hosted page guides them through the live steps: center, turn, blink, and smile.
- The completion endpoint returns a decision, and the same result is available through the signed webhook or
GET /v1/sessions/:token. - If you provided a
redirect_url, the browser is redirected there at the end too.
Quickstart
Every request needs an API key. Generate one from your dashboard, then:
POST
https://api-faceverify.bluufun.com/v1/verifyHeaders
Authorization: Bearer sk_live_...Body (form-data)
| Key | Value | Type |
|---|---|---|
| external_user_id | user-001 | Text |
| full_name | Jane Doe | Text |
| redirect_url | https://yourapp.com/verify/callback | Text |
You always get back a pending verification session with a verify_url see Verify a session for the full response shape.
All request/response examples in these docs use the live v2 flow. The old one-shot image match path is gone.