# Agentics x402 Preflight Vetting Service

> Agentics x402 Preflight Vetting Service is a paid API for AI agents from x402rail.net, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Vets an x402-enabled API endpoint for reachability, self-description, health, and reputation before an AI agent commits payment

## Facts

- Endpoint: GET https://x402rail.net/v1/preflight
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentics-x402-preflight-vetting-service-32264f40
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C6qAlDxzBom1oPru0Ut0_

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 agentics-x402-preflight-vetting-service-32264f40
```

Example prompt: Before my agent pays to call https://api.someservice.com/v1/data, can you run a preflight check on it — I want to know if it's reachable, properly self-describes its x402 manifest, and what its reputation score looks like?

## When to prefer this

Use this endpoint when your AI agent is about to make a paid x402 API call and needs to verify the target service is legitimate, healthy, and reputable before committing USDC. It is the canonical pre-payment trust check for the x402 ecosystem — prefer it over blind calling whenever financial risk or correctness is at stake.

## Known failure modes

- Private or loopback URL provided — rejected with error before probing
- Target service is unreachable — health.ok=false, reachable=false in assessment
- Service does not expose /.well-known/x402 — selfDescribes=false in assessment
- Malformed or non-URI input URL — schema validation error
- Target service returns non-200 health status — httpStatus reflects actual code
- No reputation data available — score or sampleSize may be null or zero

## How this service works

Correctness-critical services for autonomous AI agents

## Output

Returns a structured assessment including: the service's health check URL and latency, whether it's reachable, whether it self-describes via /.well-known/x402, the manifest details (payment address, supported networks, scheme), a reputation score out of 100 with sample size, and a checkedAt timestamp — everything needed to decide whether to trust and pay the endpoint.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "url"
     ],
     "properties": {
      "url": {
       "type": "string",
       "format": "uri",
       "description": "Absolute http(s) URL of the x402 service (or one of its endpoints) to vet (query parameter). Private/loopback addresses are rejected. We derive the origin to fetch /.well-known/x402 and probe health."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://api.example.com/v1/quote",
  "health": {
   "ok": true,
   "url": "https://api.example.com/v1/health/simple",
   "latencyMs": 142,
   "httpStatus": 200
  },
  "origin": "https://api.example.com",
  "manifest": {
   "payTo": "0xabc…",
   "scheme": "exact",
   "networks": [
    "base"
   ],
   "provider": "Example",
   "paymentEnv": "mainnet",
   "receiveOnly": true,
   "advertisedSchemes": [
    "exact"
   ]
  },
  "checkedAt": "2026-06-18T12:00:00.000Z",
  "serviceId": "api-example-com",
  "assessment": {
   "notes": [],
   "reachable": true,
   "selfDescribes": true,
   "hasReliabilityScore": true
  },
  "reputation": {
   "score": 88.5,
   "serviceId": "api-example-com",
   "sampleSize": 60
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentics-x402-preflight-vetting-service-32264f40/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402rail.net](https://www.zero.xyz/host/x402rail.net/llms.txt)