# ToolVet Service Report

> ToolVet Service Report is a paid API for AI agents from toolvet.app, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-12).

Fetches a comprehensive trust, health, usage, and pricing report for a specific API service listed in the ToolVet directory

## Facts

- Endpoint: GET https://toolvet.app/api/v1/services/%7Bid%7D/report?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/toolvet-service-report-abd6abc4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Urv1qc3l6SVzzk-3QcWqg

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 toolvet-service-report-abd6abc4
```

Example prompt: Pull the full ToolVet report for the service with ID 'weather-forecast' — I want to see its trust score, current price, uptime over the last 30 days, and whether the owner is verified.

## When to prefer this

Use this endpoint when you need a comprehensive, single-call snapshot of a specific API's trustworthiness, health, pricing, and usage — especially before integrating it into an AI agent workflow. Prefer it over generic uptime monitors because it combines on-chain pricing data, verified owner status, ToolVet's proprietary trust scoring, and protocol-level details in one structured response. It is the right choice when you already know the service ID and want deep due-diligence data rather than just discovery.

## Known failure modes

- Unknown service ID returns a 404 with an empty or error response
- Service exists but has no health data yet due to insufficient probing history
- Payment not included or invalid results in a 402 Payment Required response
- Network or facilitator outage causes a timeout or 5xx error
- Score breakdown fields may be absent for newly listed services with limited history

## How this service works

The vetted directory of paid APIs and MCP servers for AI agents.

## Output

Returns a JSON object containing: a list of historical events (e.g. price changes), full service metadata (ID, URL, name, kind, current price in USD and on-chain asset details, network), a trust object with a numeric score and verified_owner flag, 30-day usage stats (calls and unique payers), health metrics (live status, uptime percentage, p50 latency), category and provider labels, how-to-call instructions with an example input, daily uptime records for each day, and a detailed score breakdown across dimensions like usage, latency, pricing, protocol, security, availability, and verified ownership.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "events": [
   {
    "type": "price_changed",
    "message": "Price changed from $0.002 to $0.001"
   }
  ],
  "service": {
   "id": "weather-forecast",
   "url": "https://api.weather.example/v1/forecast",
   "kind": "x402",
   "name": "Forecast",
   "price": {
    "usd": 0.001,
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "atomic": "1000",
    "network": "eip155:8453"
   },
   "trust": {
    "score": 91,
    "verified_owner": true
   },
   "usage": {
    "calls_30d": 18233,
    "payers_30d": 412
   },
   "health": {
    "live": true,
    "uptime_30d": 99.6,
    "latency_p50_ms": 210
   },
   "category": "geo-weather",
   "provider": "Example Weather",
   "how_to_call": {
    "url": "https://api.weather.example/v1/forecast",
    "method": "GET",
    "example_input": {
     "city": "Berlin"
    }
   }
  },
  "daily_uptime": [
   {
    "day": "2026-10-10",
    "probes": 48,
    "uptime": 100
   }
  ],
  "score_breakdown": {
   "usage": 15,
   "latency": 10,
   "pricing": 10,
   "protocol": 15,
   "security": 10,
   "availability": 30,
   "verified_owner": 10
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/toolvet-service-report-abd6abc4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from toolvet.app](https://www.zero.xyz/host/toolvet.app/llms.txt)