{
  "kind": "lumi_badge_docs",
  "summary": "Free, signed, earned-only 'Tested by Lumi' badge for x402 sellers. Shown only while the seller's live Lumi score is at least 80 with at least 3 conclusive paid test-buys and the latest test-buy delivered; otherwise the SVG says 'no badge' (or 'not scored'). Never sold.",
  "endpoints": {
    "svg": "https://api.lumitrades.io/v1/badge/{key}.svg",
    "json": "https://api.lumitrades.io/v1/badge/{key}.json",
    "page": "https://api.lumitrades.io/trust/v/{key}",
    "keys": "https://api.lumitrades.io/v1/check/keys"
  },
  "key": "A Lumi vendor id (e.g. printmoneylab, from GET /v1/trust/vendors) or the exact host of a curated vendor's x402 service. One key = one seller; there is no listing or search here.",
  "threshold": {
    "min_score": 80,
    "min_paid_test_buys": 3,
    "latest_test_buy": "delivered"
  },
  "signature": "The .json verdict carries a Lumi-signed object (Ed25519, kind tested_badge, short expires_at). Verify it against Lumi's pinned public keys (lumi-scanner-kit verifyLumiSigned); a copied image proves nothing.",
  "legacy": "GET /badge and /badge/{key}.svg|.json are retired: they answer 301 to these routes (query string kept).",
  "example": {
    "badge": "https://api.lumitrades.io/v1/badge/printmoneylab.svg",
    "page": "https://api.lumitrades.io/trust/v/printmoneylab",
    "json": "https://api.lumitrades.io/v1/badge/printmoneylab.json",
    "markdown": "[![Tested by Lumi (live score, earned only)](https://api.lumitrades.io/v1/badge/printmoneylab.svg)](https://api.lumitrades.io/trust/v/printmoneylab)",
    "html": "<a href=\"https://api.lumitrades.io/trust/v/printmoneylab\"><img src=\"https://api.lumitrades.io/v1/badge/printmoneylab.svg\" alt=\"Tested by Lumi (live score, earned only)\" height=\"20\"></a>",
    "rst": ".. image:: https://api.lumitrades.io/v1/badge/printmoneylab.svg\n   :target: https://api.lumitrades.io/trust/v/printmoneylab\n   :alt: Tested by Lumi (live score, earned only)"
  },
  "how_lumi_tests": "https://lumitrades.io/how-it-works/",
  "right_to_reply": {
    "email": "hello@lumitrades.io",
    "note": "Sellers can reply to or dispute any result: email hello@lumitrades.io (mention badge key {key}), or sign a reply with a listed pay-to key via POST /v1/trust/replies. Verified replies are shown with your entry; corrections are logged publicly."
  },
  "disclaimer": "Factual test evidence, not an endorsement, rating or guarantee. The badge is earned only (live score and paid test-buy thresholds, never sold) and is removed automatically when the seller drops below them. The result page lists Lumi's latest stored paid test-buys of this service (delivered = the paid response contained data; not delivered = the seller answered without usable data; inconclusive = Lumi never saw a response, a Lumi-side outcome not counted against the seller). Past results do not predict future ones. Paying Lumi never changes a result."
}