Retrieve a Liveness Check Result API
/liveness_check
Retrieves the status or final result of a liveness check using the token returned from the create endpoint. Idempotent and safe to poll. Returns 202 while the check is pending or in progress, 200 when complete (with result object), and 410 if the link expired without completion.
Example Request
GETRequest Schema
token
Token from the create endpoint response.
Available Response Data
8 Data PointsStatus 200
result.passed boolean, result.confidence, result.threshold, result.checked_at timestamp
result.bounding_box
optional bounding box for the detected face
result.image
base64 data URI of the probe frame when retained
result.audit_images
array of intermediate frame images with bounding boxes when requested at creation
Status 202
still pending or in progress. Keep polling.
Status 410
link expired without completion
Status 400
invalid or unknown token
API reference UUID
API Data Scale & Coverage tag
Unmatched data depth to power your compliance and verification workflows.
Technical Use Cases tag
Backend polling integration
Poll from a server-side worker with exponential backoff (start at 2 to 3 seconds and back off) until the check reaches a terminal status. Stop polling once HTTP 200 is received.
Audit image retrieval
Pull intermediate audit frames (within around 30 minutes of completion) for case review or compliance archival.
Compliance & Security tag
Enterprise-grade infrastructure audited against the standards your regulators require.
Common Questions tag
Everything you need to know about implementation details and compliance infrastructure.
help_center General
How long do audit images stay available?
add
How long do audit images stay available?
Around 30 minutes after the check completes. After that, the same result is still returned, but without images.
help_center General
What's the lifecycle?
add
What's the lifecycle?
A check progresses through pending (created but not started), then in_progress (capture active), then complete / expired / failed (terminal). HTTP 202 is returned while pending or in_progress. HTTP 200 once complete. HTTP 410 if expired without completion.
help_center General
Should I trust the client-side redirect lc_token?
add
Should I trust the client-side redirect lc_token?
Never. Always validate the result via this authenticated GET call from your backend. The redirect parameter could be tampered with before reaching you.
API Testing Sandbox tag
Test the Retrieve a Liveness Check Result API directly in your browser with live mock data and see instant results.
rocket_launch Request Sandbox AccessAccess to live sandbox environments requires manual approval from our compliance team.