Commerce CensusContactRequest access

API / Trust & risk

Offer 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

Request

No parameters beyond the path and your bearer token.

Request & response
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." }

Notes

`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.