Skip to content
Trust score · methodology

How Trust Score v4.1 is calculated

Trust Score v4.1 combines three weighted dimensions with an optional external-assurance bonus and confidence-tier caps. Each response identifies the engine used; some responses fall back to legacy v2. A legacy v2 component breakdown does not explain an overall score produced by v4.1.

Methodology snapshot reviewed 2026-09-13. Check the live endpoint for current weights and engine selection.

Current methodology · per-response engine

v4.1: three weighted dimensions and an optional bonus

Read engines.overall and engines.breakdown before interpreting a score. overall uses 0–1; trust_score_v41 uses 0–100 when available. With engines.mixed=true, the breakdown does not explain overall. insufficient_data is missing usable evidence, not a measured zero; the public route can return a degraded v2 fallback.

v4.1 available · v2 fallback possible · read engines

Three weighted dimensions + External Assurance

v4.1 weights depend on confidence and are renormalized over applicable dimensions. External Assurance adds up to 10 points after the base score, subject to its gates and the tier cap; it is not a fourth weighted dimension.

Confidence tiers: caps and per-dimension weights

A store's confidence tier is set by its order history, not chosen by the merchant. The tier both caps the maximum score and sets how much each dimension counts.

Data-quality vocabulary

Every signal behind the score is tagged with one of these six levels, published alongside the number so a reader can tell measured fact from merchant claim.

Read the full trust score story

Legacy v2 · compatibility

Legacy v2: 12 weighted components

These weights describe v2 only (0–1 scale), including its fallback path. They do not explain an overall score produced by v4.1. The methodology endpoint retains the fields for compatibility and identifies their scope under legacy_v2.

Legacy v2 formula: weighted_sum_clamped_0_1 · scheduled every 6 hours

Legacy v2 reference

Published display-label bands (0–1)

These are the display-label thresholds published by the trust-score endpoint, not permissions to act — a score label, identity verification level and operational status are different fields. Consult the policy of the specific endpoint.

Evidence and limits

What verification establishes

If you disagree with your score

Dispute process

Merchants can formally appeal a score they believe is wrong.

Endpoint
POST /api/v1/trust/appeal
Response SLA
72h
Documentation
/trust
Questions

Frequently asked

Can a merchant improve their score by self-reporting good numbers?

v4.1 labels signal quality and redistributes weight when evidence is not applicable. In the legacy v2 table, 10 of 12 components are labelled verified (weight 0.87); policy_coverage and review_sentiment are declared. These v2 labels do not prove that every input was independently verified.

How often does the score change?

The legacy v2 component job is scheduled every 6 hours. The public v4.1 overlay can be computed on request. Read the engine, calculated_at and freshness fields together; a mixed response can carry v2 timing alongside a v4.1 overall.

Where do I get today's actual number for a store?

Read the signed public response from the merchant’s declared API host: /api/v1/stores/{slug}/trust-score. Check engines, scales and confidence; a signature authenticates the record, not the reliability of every underlying input.

Is v4.1 (0–100 scale, tiers) live?

Trust Score v4.1 combines three weighted dimensions with an optional external-assurance bonus and confidence-tier caps. Each response identifies the engine used; some responses fall back to legacy v2. A legacy v2 component breakdown does not explain an overall score produced by v4.1.

How Trust Score v4.1 is calculated | Trusteed