Concepts

Results & decisions

How checks roll up into a decision, and how to decide manually.

The result

GET /sessions/{id}/result returns the status, the per-check results and the decision:

{
  "status": "APPROVED",
  "checks": [
    { "type": "DOCUMENT", "result": "passed", "score": 0.98 },
    { "type": "LIVENESS", "result": "passed", "score": 0.94 },
    { "type": "FACE_MATCH", "result": "passed", "score": 0.91 }
  ],
  "decision": { "outcome": "APPROVED", "mode": "AUTO" }
}

Decision modes

  • AUTO — AveTrust computes the outcome from the checks. Clear passes become APPROVED, clear failures REJECTED, borderline cases REVIEW.
  • MANUAL — every session lands in REVIEW for a human to decide.

Decide manually

For sessions in REVIEW:

curl https://api.avetrust.net/api/v1/sessions/SESSION_ID/decision \
  -H "X-Api-Key: $AVETRUST_API_KEY" -H "Content-Type: application/json" \
  -d '{ "outcome": "approved", "note": "Reviewed by agent" }'

A verdict is a moment in time

Once a session reaches APPROVED/REJECTED, that's the record of the check. Start a new session to re-verify a user.

Next steps

On this page