Docs menu

Trust score

Combine the signals you hold into one weighted 0 to 100 trust score for a seller or buyer.

Combine results you already hold into one 0 to 100 trust score for a seller or buyer. You send the signals, each as a value from 0 to 1, and we weight them.

curl -sS -X POST 'https://api.trustverify.co.uk/api/v1/trust-score' \
  -H "Authorization: Bearer $TRUSTVERIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "entityId": "seller_demo_42",
  "signals": [
    {
      "type": "aml_result",
      "value": 1
    },
    {
      "type": "biometric_match",
      "value": 0.9
    },
    {
      "type": "account_age",
      "value": 0.4
    }
  ]
}'

Weights#

Signal type	Weight
`biometric_match`	0.25
`aml_result`	0.20
`document_authenticity`	0.15
`device_fingerprint`	0.10
`ip_risk`	0.10
`transaction_history`	0.10
`account_age`	0.05
`communication_pattern`	0.05
Any other type	0.05

Read the result#

trustScore is 0 to 100. With no signals it is 50.
tier is trusted (75+), provisional (50+), elevated_risk (25+) or blocked.
escrowGate says whether the score is at or above 40, for marketplaces that hold funds until a seller is trusted.

Escrow

Escrow itself is available on request and is set up with you from the dashboard. It is not part of the published API. Contact us to ask about it.

Reference: POST /api/v1/trust-score.