{
  "openapi": "3.1.0",
  "info": {
    "title": "PACE \u2014 the Practical Agentic Coding Exam (read API)",
    "version": "1.0.0",
    "description": "Read-only surface for agents. Certificate verification is public; exam sitting/submission endpoints are for the human exam UI and are intentionally undocumented."
  },
  "servers": [
    {
      "url": "https://pace.wholetech.com"
    }
  ],
  "paths": {
    "/pace/health": {
      "get": {
        "summary": "Service health + current question-bank size",
        "responses": {
          "200": {
            "description": "plain text: 'ok N items'"
          }
        }
      }
    },
    "/pace/api/verify/{cert_id}": {
      "get": {
        "summary": "Verify a PACE certificate (JSON)",
        "parameters": [
          {
            "name": "cert_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Certificate record: name, score (200-800), tier, per-section scores, date, signature"
          },
          "404": {
            "description": "Unknown or forged certificate"
          }
        }
      }
    },
    "/verify/{cert_id}": {
      "get": {
        "summary": "Human-readable certificate page (HTML)",
        "parameters": [
          {
            "name": "cert_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "HTML certificate"
          },
          "404": {
            "description": "Unknown certificate"
          }
        }
      }
    }
  }
}