How do I put a verifiable receipt badge on my README?

Paste the markdown snippet linking badge.svg to your receipt's live badge page. The badge links to a page that shows the current verification state of your receipt.

Is the badge state live or a static image?

The badge page reflects the most recent live verification check. An independent verifier re-checks tracked receipts every few minutes against the zambo.dev verify API, and the badge renders that state. It never shows a passing state that was not actually checked.

What is the difference between the receipt badge and the AER-1 conformant badge?

The receipt badge is per run: it shows that one specific agent execution produced a verifiable receipt. The conformant badge is per implementation: it shows an implementation passed the AER-1 conformance kit.

The verifiable receipt badge.

Your agent did the work. Prove it where people look. Paste one snippet and your page, README, or agent profile shows a live verifiable AER-1 execution receipt, with a link back to the receipt on zambo.dev. No signup, no key, no JavaScript framework.

Live demo

This is a real receipt, checked live. The badge below renders the current verification state of receipt d34673d1…9b38, a live MCP tool execution from the public stream.

Badge (iframe, live state)

Widget (script, live state)

Snippet 1: badge for any page

Drop this iframe where you want the badge. Replace the receipt id with your own.

<iframe
  src="https://rambozambodotdev.gitlab.io/aer1-hub/badge/?receipt=d34673d1-c998-4d3e-ae3d-496464ec9b38"
  width="250" height="72" frameborder="0" scrolling="no"
  title="Verifiable receipt badge">
</iframe>

Snippet 2: widget card for any page

Richer than the badge: job summary, tools, fingerprint, and verify links. One div, one script.

<div data-aer1-receipt="d34673d1-c998-4d3e-ae3d-496464ec9b38"></div>
<script src="https://rambozambodotdev.gitlab.io/aer1-hub/widget/aer1-widget.js"></script>

Snippet 3: badge for a README

Markdown image linking to the live badge page for your receipt. Works on GitLab, npm, and anywhere markdown renders.

[![verifiable receipt](https://rambozambodotdev.gitlab.io/aer1-hub/badge/badge.svg)](https://rambozambodotdev.gitlab.io/aer1-hub/badge/?receipt=d34673d1-c998-4d3e-ae3d-496464ec9b38)

Renders as:

Badge your own receipt: the generator

Paste the id of any receipt from zambo.dev and get all three snippets with your id already filled in. No editing, no mistakes.

1. Badge iframe for your page

2. Widget card for your page

3. Badge for your README

Live preview:

How the state stays honest

The badge never shows a passing state that was not actually checked. An independent verifier re-checks every tracked receipt against the live zambo.dev verify API every few minutes and publishes the results. The badge page tries the live API first, then falls back to the most recent check and tells you how long ago it ran.

Two honest limits, stated plainly:

1. The badge covers receipts in the public tracked set. A receipt outside the set shows a neutral state and links straight to its live verification page on zambo.dev, where anyone can check it.
2. Verification proves the recorded bytes were not changed. It does not prove the upstream data was true. That is what the evidence links on the receipt page are for.

This badge is per run: it vouches for one execution. The AER-1 conformant badge is different: it vouches for an implementation that passed the conformance kit. Use both.

Get your own receipt to badge

Run the 30 second demo, no signup. Every run issues a real verifiable receipt you can badge on the spot.

Try the demo and badge your receipt

See it on a real call: the live demo runs one real Zambo call and hands you its verifiable receipt, no signup. To put a receipt under every call your agent makes, a Zambo Day Pass unlocks everything for 24 hours for $0.99.