Skip to main content
Savings receipts are Tavryn’s verifiable proof-of-outcome artifacts. Every time the agent completes a negotiation and settles a USDC payment, it generates a receipt — a lightweight public document that records the original price, the negotiated price, the realized savings, and (for real transactions) a link to the on-chain Arc settlement. Receipts are identified by a 128-bit random token and accessible at /r/{token} without any login required, making them easy to share with finance teams, auditors, or investors.

Receipt Object

string
32-character hex token (128 bits of entropy) that identifies this receipt. Used as the path parameter in the public receipt URL /r/{token}.
string
Human-readable name of the SaaS or cloud service that was renegotiated. Example: "Datadog Cloud Monitoring".
string
Spend category of the contract. One of software, cloud, contractors, infrastructure, legal, or marketing.
string | null
Name of the organization that achieved this saving. null if the business has disabled name visibility via the showBusinessName privacy flag.
string | null
Name of the vendor. null if vendor name visibility is disabled via showVendorName.
number
The annual contract price before Tavryn’s negotiation, in USD.
number
The negotiated annual price, in USD. This is the USDC amount settled on-chain.
number
Calculated as oldPrice − newPrice. Always ≥ 0.
number
Savings as a percentage of the original price, rounded to the nearest integer.
number
Number of negotiation rounds the agent ran before reaching the final price.
string
Plain-language summary of how the agent reached this outcome, drawn from the audit log.
array
object
object
boolean
true when this receipt corresponds to a mock/testnet transaction that did not spend real USDC.
string | null
The on-chain transaction hash of the escrow release. null for simulated receipts.
string
ISO 8601 timestamp of when the receipt was created.

GET /api/receipts/

Fetch the public view model for a single savings receipt. This endpoint is publicly accessible — no authentication is required. It is rate-limited to 60 requests per minute per IP address to prevent enumeration attacks.
For real (non-simulated) transactions, the arcExplorerUrls.releaseTxUrl field points directly to the ArcScan block explorer entry for the escrow release transaction. Anyone — including vendors, auditors, or investors — can independently verify that the payment occurred by visiting that URL. This on-chain verifiability is a core part of Tavryn’s trust model.
Path parameters
string
required
The 32-character hex receipt token. You obtain this from the receipt record returned after a transaction completes, or from the receiptUrl field in a createReceipt response.
Example request
Example response
Error responses

PATCH /api/receipts/

Update the privacy settings of an existing receipt or permanently revoke public access. Revoked receipts return 404 to all subsequent GET requests — even with the original token. Path parameters
string
required
The receipt token to update.
Request body
string
UUID of the owning business. Optional if the server can resolve ownership from the token, but recommended for explicit authorization.
boolean
Set to true to permanently revoke public access. Irreversible. Revoking a receipt records an audit log entry and disables the public /r/{token} URL immediately.
boolean
Control whether businessName appears in the public receipt view.
boolean
Control whether vendorName appears in the public receipt view.
Example request — revoke a receipt
Example response

Public Receipt URL

Every receipt is accessible at a shareable URL with no authentication required:
This URL renders a full savings certificate page including the policy checklist, verification badges, and (for real transactions) a clickable ArcScan link. Share it with finance teams, auditors, or include it in vendor communication as proof of settlement.
The public receipt URL intentionally returns the same 404 page for both nonexistent and revoked tokens. This prevents a third party from determining whether a receipt was revoked or simply never existed.