# Boon Protocol X402 Endpoint Review Publisher

> Boon Protocol X402 Endpoint Review Publisher is a paid API for AI agents from api.boonprotocol.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-16).

Publishes a wallet-signed subjective review for an x402 endpoint to the Boon Protocol review registry

## Facts

- Endpoint: POST https://api.boonprotocol.com/api/v1/x402/reviews/self-reported
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/boon-protocol-x402-endpoint-review-publisher-e9a5dc8a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xqnP2_KQVwVaFUVDnISJh

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 boon-protocol-x402-endpoint-review-publisher-e9a5dc8a -d '<json body>'
```

Example prompt: Submit a review for x402 route 0x1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e0f1a2b on Boon Protocol from my wallet 0xAbCd1234567890EFabcd1234567890EFabcd1234 — the review text is 'Fast response times, accurate pricing, highly reliable endpoint' — sign it with my wallet and post it now.

## When to prefer this

Use this endpoint when an agent or user wants to submit a cryptographically-signed, subjective text review for a specific x402 API endpoint by its route ID, attested by an Ethereum wallet (EOA or ERC-1271 contract). Prefer this over read endpoints when the goal is to write new review data into the Boon Protocol registry. This is the self-reported review pathway — choose it when the reviewer is attesting their own experience rather than relying on receipt verification or gratuity backing.

## Known failure modes

- Invalid routeId format (not a 0x-prefixed 64-char hex string) — 400 Bad Request
- Invalid reviewer address format (not a valid 0x Ethereum address) — 400 Bad Request
- Signature mismatch or invalid signature for the given reviewer — 401/403 Unauthorized
- Review text exceeds 1000 UTF-8 bytes — 400 Bad Request
- Wrong version or policyVersion values — 400 Bad Request
- Payment not provided or insufficient (requires $0.05 USDC via x402) — 402 Payment Required
- Duplicate review submission for same reviewer/route combination — 409 Conflict

## How this service works

Publish one wallet-signed subjective x402 endpoint review

## Output

A confirmation that the wallet-signed subjective review has been recorded in the Boon Protocol x402 review registry, associated with the specified route ID and reviewer wallet address.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "review": {
   "type": "object",
   "required": [
    "version",
    "policyVersion",
    "routeId",
    "reviewer",
    "reviewText",
    "createdAt"
   ],
   "properties": {
    "routeId": {
     "type": "string",
     "pattern": "^0x[0-9a-fA-F]{64}$"
    },
    "version": {
     "enum": [
      "3"
     ],
     "type": "string"
    },
    "reviewer": {
     "type": "string",
     "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "createdAt": {
     "type": "integer",
     "minimum": 0
    },
    "reviewText": {
     "type": "string",
     "maxLength": 1000,
     "minLength": 1,
     "x-max-utf8-bytes": 1000
    },
    "policyVersion": {
     "enum": [
      "boon.x402-review-policy/v3"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "signature": {
   "type": "string",
   "pattern": "^0x(?:[0-9a-fA-F]{2})+$",
   "maxLength": 8194,
   "description": "65-byte EOA signature by review.reviewer. ERC-1271 contract signatures are accepted by the runtime and may use their contract-defined byte length."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "review": {
   "reviewText": "Useful for a narrow query.",
   "evidenceKind": "self_reported"
  },
  "routeId": "0x1212121212121212121212121212121212121212121212121212121212121212",
  "version": "3"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/boon-protocol-x402-endpoint-review-publisher-e9a5dc8a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.boonprotocol.com](https://www.zero.xyz/host/api.boonprotocol.com/llms.txt)