Developers
BioTrust API
Integrate biometric trust intelligence with a small, predictable API surface. This is a prototype specification; endpoints and shapes may evolve.
Introduction
The BioTrust API returns a Biometric Trust Score, a decision recommendation and the underlying signals for a facial capture. It is designed to plug into existing eKYC and identity workflows without replacing the recognition engine.
Authentication
Include your workspace API key as a bearer token.
Authorization: Bearer sk_sbx_...
Content-Type: application/jsonPOST /v1/analyze
Analyze a capture and receive an explainable Trust Score.
curl -X POST https://api.biotrust.ai/v1/analyze \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"image_url": "https://example.com/capture.jpg", "use_case": "ekyc-onboarding"}'{
"analysis_id": "bt_demo_7f42a1",
"trust_score": 82,
"decision": "review",
"confidence": 0.88,
"signals": {
"biometric_quality": 91,
"authenticity": 76,
"attack_resistance": 79,
"capture_context": 84
},
"reasons": [
{
"code": "AUTHENTICITY_UNCERTAINTY",
"severity": "medium",
"message": "Local image-processing indicators require review."
}
],
"recommended_action": "Route to assisted verification."
}GET /v1/analyses/{id}
Fetch a previously-produced analysis by ID.
curl https://api.biotrust.ai/v1/analyses/bt_demo_7f42a1 \
-H "Authorization: Bearer $API_KEY"Error model
Errors use a consistent JSON envelope.
{
"error": {
"code": "INVALID_IMAGE",
"message": "Uploaded content is not a supported image type.",
"request_id": "req_01H3…"
}
}Webhooks (concept)
Webhooks will emit analysis.completed and policy.updated events. Handlers should verify a signed header. Planned for a future release.
Rate limits (concept)
Sandbox workspaces are rate-limited to modest volumes. Production limits will be agreed as part of a pilot. Requests over the limit return HTTP 429.
Playground
This playground calls a local mock service — no biometric data is transmitted anywhere.