{
  "openapi": "3.1.0",
  "info": {
    "title": "Is It Agent Ready — Scanner API",
    "version": "1.0.0",
    "description": "Score any URL for AI-agent readiness."
  },
  "servers": [{ "url": "https://itisagentready.com/api" }],
  "paths": {
    "/scan": {
      "get": {
        "operationId": "scanAgentReadiness",
        "summary": "Scan a URL for agent readiness",
        "parameters": [
          { "name": "url", "in": "query", "required": true, "schema": { "type": "string", "format": "uri" } }
        ],
        "responses": {
          "200": {
            "description": "Scan result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "url": { "type": "string" },
                    "score": { "type": "integer", "minimum": 0, "maximum": 100 },
                    "verdict": { "type": "string" },
                    "checks": { "type": "array", "items": { "type": "object" } },
                    "remediation": { "type": "array", "items": { "type": "object" } },
                    "opportunity_cost": { "type": "object" },
                    "receipt": { "type": "object" }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/leaderboard": {
      "get": {
        "operationId": "viewLeaderboard",
        "summary": "Read the public leaderboard",
        "responses": { "200": { "description": "Leaderboard rows + stats" } }
      }
    }
  }
}