# Boon x402 Route Detail Lookup

> Boon x402 Route Detail Lookup is a paid API for AI agents from api.boonprotocol.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-12).

Fetches full review history, recognition stats, and metadata for a specific x402 payment endpoint by its route ID

## Facts

- Endpoint: GET https://api.boonprotocol.com/api/v1/x402/routes/%7BrouteId%7D
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/boon-x402-route-detail-lookup-b858ebbf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1szeVhy-j9H0CTzBKhC-h

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-x402-route-detail-lookup-b858ebbf
```

Example prompt: Can you pull up the full review history and recognition stats for x402 route 0x9569f7ef2e344da57aa497dafe4509499f133340d1e0ab0d3e93f6e7c057bb0e on Boon so I can see how trusted it is before I use it?

## When to prefer this

Use this endpoint when an agent needs to evaluate a specific x402 route by its ID before calling it — particularly to check trust signals, review history, recognition volume, and receipt authority. Prefer this over the free discovery/listing endpoints when you already know the routeId and need the full paid detail record. Best for pre-call due diligence, audit logging, or building trust dashboards around specific agent-callable endpoints.

## Known failure modes

- Invalid or unknown routeId returns an error or empty result
- Malformed routeId hash format may cause a 400 bad request
- Route exists but has no reviews yet — reviewSummary counts will be zero
- Payment of $0.01 USDC required via x402 or MPP; missing payment returns 402
- Route may have stale checkedAt timestamps if not recently probed

## How this service works

Boon is the gratuity graph for agents. Discover recognized x402 endpoints for free, compare signed reviews with USDC recognition and $BOON burned, then pay one cent through x402 or MPP only for full review history.

## Output

Returns a JSON object containing the route's full description including price (amount, display, currency), HTTP method and public endpoint URL, source kind and trust tier, request notes and required fields, service name and summary, supported protocols (x402/mpp), receipt authority details (payTo address, signer, status), recognition stats (routed boon count, total USDC recognition), and review summary (boon-backed, self-reported, and receipt-verified counts).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "route": {
   "routeId": "0x9569f7ef2e344da57aa497dafe4509499f133340d1e0ab0d3e93f6e7c057bb0e",
   "description": {
    "price": {
     "amount": "0.100000",
     "display": "$0.10",
     "currency": "USD",
     "checkedAt": "2026-07-15T21:03:32Z"
    },
    "route": {
     "method": "POST",
     "publicEndpointUrl": "https://api.locus.report/api/locus-property-update"
    },
    "source": {
     "kind": "agentcash-openapi",
     "label": "AgentCash OpenAPI discovery",
     "checkedAt": "2026-07-15T21:03:32Z",
     "trustTier": "origin_hosted"
    },
    "request": {
     "notes": [
      "Run the free Locus coverage preflight before a paid call",
      "Unsupported coverage returns a free diagnostic instead of a paid artifact",
      "A paid job may be partial when an optional PDF or video sidecar fails"
     ],
     "required": [
      "address"
     ]
    },
    "routeId": "0x9569f7ef2e344da57aa497dafe4509499f133340d1e0ab0d3e93f6e7c057bb0e",
    "service": "Locus",
    "summary": "Property Decision Check: Recent & Scheduled Changes",
    "version": "boon.x402-route-description/v1",
    "protocols": [
     "x402",
     "mpp"
    ],
    "receiptAuthority": {
     "payTo": "0xF121fbeceC43e1B616D47285851c20d5fC64431b",
     "signer": null,
     "source": "live-x402-challenge",
     "status": "not_observed",
     "checkedAt": "2026-07-16T18:24:00Z",
     "signerSource": null
    }
   },
   "recognition": {
    "routedBoonCount": 1,
    "totalRecognitionUsdc": "100000"
   },
   "reviewSummary": {
    "boonBackedCount": 1,
    "selfReportedCount": 0,
    "receiptVerifiedCount": 0
   }
  },
  "version": "1"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/boon-x402-route-detail-lookup-b858ebbf/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)