{
  "openapi": "3.1.0",
  "info": {
    "title": "verify-service \u2014 x402 paid endpoint",
    "version": "1.0.0",
    "description": "Send the URL of an x402 endpoint. It is probed three times without payment, then matched against the PayAI discovery catalog. You get a verdict (ALIVE / SLOW / BROKEN / NOT-402 / INDEXED / NOT-INDEXED), success rate, latency p50/p95, payTo and last catalog update.",
    "x-guidance": "POST /api/verify-service with JSON {\"url\":\"https://endpoint.example/api/route\"}. Unpaid calls return HTTP 402 with x402 v2 terms (USDC on Base, $0.001 per call). Use it before paying a new seller or before listing your own endpoint.",
    "contact": {
      "email": "hello@desk.node01.org",
      "url": "https://market.node01.org/"
    }
  },
  "servers": [
    {
      "url": "https://verify-service.node01.org"
    }
  ],
  "paths": {
    "/api/verify-service": {
      "post": {
        "operationId": "verify_service",
        "summary": "Trust check for any x402 endpoint: alive, slow, broken or never indexed, with success rate, latency and payment evidence.",
        "tags": [
          "x402",
          "verification",
          "trust",
          "uptime"
        ],
        "x-payment-info": {
          "price": {
            "mode": "fixed",
            "currency": "USD",
            "amount": "0.001000"
          },
          "protocols": [
            {
              "x402": {}
            }
          ]
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "Full https URL of the x402 endpoint to verify",
                    "examples": [
                      "https://canary.node01.org/api/canary"
                    ]
                  }
                },
                "required": [
                  "url"
                ]
              },
              "example": {
                "url": "https://canary.node01.org/api/canary"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid call succeeded",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "url": "https://canary.node01.org/api/canary",
                  "status": "ALIVE",
                  "success_rate": 1.0,
                  "latency_ms": {
                    "p50": 120,
                    "p95": 180
                  },
                  "catalog": {
                    "found": true,
                    "service_name": "canary"
                  }
                }
              }
            }
          },
          "402": {
            "description": "Payment Required \u2014 x402 v2 challenge in the PAYMENT-REQUIRED header"
          }
        }
      }
    },
    "/api/health": {
      "get": {
        "operationId": "health_check",
        "summary": "Free liveness check",
        "security": [],
        "responses": {
          "200": {
            "description": "Service is alive"
          }
        }
      }
    }
  }
}
