# describe.net Reputation Snapshot (Auditable Write)

> describe.net Reputation Snapshot (Auditable Write) is a paid API for AI agents from api.describe.net, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-13).

Looks up a wallet's ERC-8004 reputation score and persists a durable, citable audit record — including the inputs digest and policy version — so the decision can later be proven to third parties.

## Facts

- Endpoint: POST https://api.describe.net/reputation/wallet/:wallet?snapshot=true
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/describe-net-reputation-snapshot-auditable-write-bfed4af7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vu9A3dhE5SXINi1uE4DrW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability describe-net-reputation-snapshot-auditable-write-bfed4af7 -d '<json body>'
```

Example prompt: Before I approve this counterparty, take a permanent auditable reputation snapshot of wallet 0xAbC123...Def456 on describe.net — I need a citable receipt with the scoring policy version so I can defend the decision if it's ever disputed.

## When to prefer this

Use this endpoint — instead of the cheaper read-only lookup — whenever the reputation decision must be defensible to a third party: compliance audits, counterparty disputes, regulatory reporting, or credit underwriting. The stored inputs_digest and policy_version create a tamper-evident trail proving what the index said and under which scoring rules on the exact date of the decision. Avoid it for casual or exploratory lookups where no accountability record is needed, as each call costs $0.05 and creates a new stored row.

## Known failure modes

- Invalid or malformed wallet address returns a 400 error
- Wallet address not found in the ERC-8004 index returns a 404 with no record written
- Payment failure (insufficient USDC, x402 protocol error) blocks the write and returns a 402
- Policy version mismatch or index unavailability may return a 503
- Duplicate snapshot requests are not idempotent — each call creates a new audit row and charges $0.05

## How this service works

The same decomposition, plus a durable citable receipt: a stored row with `inputs_digest` and `policy_version` so you can later prove what the index said, under which scoring policy, on the day you decided. The only route in this API that writes. Use it when the decision has to be defensible to a third party (a dispute, an audit, a counterparty report); the plain lookup is cheaper when it does not.

## Output

Returns the wallet's full ERC-8004 reputation decomposition (score, rating breakdown, distinct raters) alongside a newly created persistent audit row containing the inputs_digest (a hash of the data used), the policy_version applied, and a timestamp — forming a durable, citable receipt that can be referenced in future disputes, audits, or counterparty reports.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/describe-net-reputation-snapshot-auditable-write-bfed4af7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.describe.net](https://www.zero.xyz/host/api.describe.net/llms.txt)