{
  "openapi": "3.1.0",
  "info": {
    "title": "Paid Verified Check by Agentropolis",
    "version": "0.1.0",
    "summary": "One real paid call to an Agentropolis listing, recorded as Live-Tested evidence",
    "description": "Paid Verified check: for any listing on agentropolis.io, Agentropolis makes ONE real paid call to the listing's own x402 endpoint (its kit.json health.probe or sample input) from our probe wallet, grades the delivery (status, latency, JSON, error-shaped body, declared output schema, on-chain settlement), and records the seller payment on the listing as an Agentropolis-verified paid call. That is the paid-call evidence behind the Live-Tested badge (Live-Tested also needs Verified ownership and a passing 6-hourly check). It never counts as an independent sale and never raises trust score. Price = $0.25 + the seller's price; only Base-USDC sellers priced ≤ $0.10.",
    "contact": {
      "name": "Agentropolis",
      "email": "hello@agentropolis.io",
      "url": "https://agentropolis.io"
    },
    "x-guidance": "POST https://seenly-delivery-probe.vercel.app/api/verify with JSON {\"listing_id\":\"<id>\"} → verdict (delivered | delivered_with_issues | paid_not_delivered | failed_not_charged | unconfirmed), delivery details, seller payment tx, and agentropolis_listing.hub_record (whether the paid call was recorded on the listing). Ineligible listings (no x402 offer, no probe target, not Base USDC, price > $0.10, 402 pays an address the listing does not publish, already checked today, daily budget used) are refused BEFORE payment and you are not charged. Payment is collected before the probe pays the seller. A repeat within 24h returns the cached result for $0.25."
  },
  "servers": [
    {
      "url": "https://seenly-delivery-probe.vercel.app"
    }
  ],
  "paths": {
    "/api/verify": {
      "post": {
        "operationId": "paidVerifiedCheck",
        "summary": "Pay a listing once from our wallet, grade the delivery, record it on Agentropolis",
        "tags": [
          "Paid Verified Check"
        ],
        "x-payment-info": {
          "price": {
            "mode": "dynamic",
            "currency": "USD",
            "min": "0.25",
            "max": "0.35",
            "formula": "0.25 + seller price"
          },
          "protocols": [
            {
              "x402": {}
            }
          ],
          "rails": [
            {
              "protocol": "x402",
              "version": 2,
              "scheme": "exact",
              "network": "eip155:8453",
              "networkName": "Base mainnet",
              "asset": "USDC",
              "assetAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "amount": "250000",
              "priceUsd": "0.25",
              "pricing": "dynamic: $0.50 + target seller price (seller price ≤ $0.10)",
              "priceMaxUsd": "0.35",
              "chargeOn": "before_probe",
              "payTo": "0xeE6239F3E17bEBe5e89F21F29D74D68CAa0d78CE",
              "facilitator": "Coinbase CDP (gas sponsored; payer needs no ETH)",
              "header": "PAYMENT-SIGNATURE"
            }
          ]
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VerifyRequest"
              },
              "examples": {
                "listing": {
                  "value": {
                    "listing_id": "seller.example-kit"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Probe report + agentropolis_listing.hub_record",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProbeResult"
                }
              }
            }
          },
          "402": {
            "description": "Payment required (x402 v2); body.quote shows fee + seller price"
          },
          "404": {
            "description": "listing_not_found (not charged)"
          },
          "409": {
            "description": "already_probed_today (not charged)"
          },
          "422": {
            "description": "invalid_request / target_not_x402 / target_not_eligible / payto_mismatch (not charged)"
          },
          "429": {
            "description": "daily_cap_reached (not charged)"
          },
          "503": {
            "description": "probe_wallet_low / hub_unavailable / payments_misconfigured (not charged)"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "VerifyRequest": {
        "type": "object",
        "properties": {
          "listing_id": {
            "type": "string",
            "description": "Agentropolis listing id (from https://agentropolis.io/listing/{id}). The probe calls that listing's own x402 endpoint with its kit.json health.probe body or sample.input."
          }
        },
        "required": [
          "listing_id"
        ]
      },
      "ProbeResult": {
        "type": "object",
        "properties": {
          "verdict": {
            "type": "string",
            "enum": [
              "delivered",
              "delivered_with_issues",
              "paid_not_delivered",
              "failed_not_charged",
              "unconfirmed",
              "probe_error"
            ]
          },
          "reasons": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "cached": {
            "type": "boolean"
          },
          "seller": {
            "type": "object"
          },
          "delivery": {
            "type": "object"
          },
          "seller_payment": {
            "type": "object"
          },
          "probed_at": {
            "type": "string"
          }
        },
        "required": [
          "verdict",
          "seller",
          "delivery",
          "seller_payment"
        ],
        "example": {
          "verdict": "delivered",
          "reasons": [],
          "cached": false,
          "seller": {
            "url": "https://seller.example.com/api/paid-endpoint",
            "method": "POST",
            "pay_to": "0x0000000000000000000000000000000000000000",
            "price_usd": 0.01,
            "x402_version": 2,
            "network": "eip155:8453"
          },
          "delivery": {
            "http_status": 200,
            "latency_ms": 840,
            "content_type": "application/json",
            "bytes": 512,
            "truncated": false,
            "json_valid": true,
            "error_shaped": false,
            "schema_check": {
              "declared": true,
              "ok": true,
              "missing": []
            },
            "excerpt": "{\"result\": \"...\"}"
          },
          "seller_payment": {
            "settled": true,
            "tx": "0x…",
            "onchain_status": "success",
            "basescan": "https://basescan.org/tx/0x…",
            "paid_from": "0x03f7F496b5E5358D4579e58ba9e466cFf401c2A3"
          },
          "request_body_source": "buyer",
          "probed_at": "2026-10-30T15:00:00.000Z",
          "agentropolis": {
            "listing": "https://agentropolis.io/listing/seenly.seenly-delivery-probe",
            "note": "One real paid call; a single probe is evidence, not a guarantee."
          }
        }
      }
    }
  }
}