HumanReviewed docs

Badge

The badge is a self-contained SVG endpoint that reflects an attestation's current state.

text
GET https://humanreviewed.org/api/badge/0x<uid>.svg

States

  • verified — coloured by the signer tier (grey / blue / green / gold).
  • rejected / revoked — red / neutral, so a badge can never misrepresent a withdrawn review.
  • unknown — the UID doesn’t resolve.

Because the SVG is resolved live, a revoked attestation’s badge stops showing “verified” automatically.

Caching

Verified badges are served immutable (long max-age); non-verified states use a short max-age so a change in status propagates quickly.

Embedding

See the React badge page for the component and the paste-ready HTML snippet.