API / Trust & risk
Flags on an individual offer: price far below the product's own distribution, a seller new to the listing, condition ambiguity, region mismatch.
GET /v1/offers/{id}/risk
No parameters beyond the path and your bearer token.
GET /v1/offers/off_91kd/risk
→ 200
{ "risk": "elevated",
"flags": [
{ "code": "price_implausible", "severity": "high",
"detail": "68% below the 90-day 5th percentile across all sellers" },
{ "code": "seller_new_to_listing", "severity": "medium",
"detail": "First observed on this product 3 days ago" },
{ "code": "region_variant", "severity": "low",
"detail": "Likely an EU-market unit; plug and warranty may differ" } ],
"recommendation": "Do not auto-purchase. Surface to the user with the flags." }`price_implausible` is the single most useful flag for an agent with a budget instruction. A price far below every other seller is usually a different item, a different region, or a listing that will be cancelled.
Flags describe observations, not accusations. The API reports that a price is far outside the distribution; it does not assert fraud.