{
  "openapi": "3.1.0",
  "info": {
    "title": "VINTrakID Public API",
    "version": "2026.02",
    "summary": "Root-level OpenAPI discovery document for AI-agent scanners.",
    "description": "VINTrakID is a closed-beta vehicle equity intelligence platform. The canonical machine-readable OpenAPI specification is served at https://vintrakid.com/api/openapi.json. This root document exists so AI-agent compliance scanners (Agent-Ready / MPP) can discover the API surface from the site root. **Machine Payment Protocol (MPP) is intentionally NOT supported** — VINTrakID does not accept agent-initiated payments; the absence of any `x-payment-info` extension is deliberate.",
    "contact": {
      "name": "VINTrakID Partner Team",
      "email": "partners@vintrakid.com",
      "url": "https://vintrakid.com/partner/signup"
    },
    "license": {
      "name": "Proprietary — closed beta",
      "url": "https://vintrakid.com/terms"
    }
  },
  "servers": [
    {
      "url": "https://vintrakid.com/api",
      "description": "Production API root. See /api/openapi.json for the full spec."
    }
  ],
  "externalDocs": {
    "description": "Full OpenAPI 3.1 specification (canonical, machine-generated)",
    "url": "https://vintrakid.com/api/openapi.json"
  },
  "tags": [
    {
      "name": "discovery",
      "description": "Public discovery endpoints — no authentication required."
    },
    {
      "name": "auth",
      "description": "Agent authentication. See https://vintrakid.com/auth.md — closed-beta partner credentials only."
    }
  ],
  "paths": {
    "/openapi.json": {
      "get": {
        "tags": ["discovery"],
        "summary": "Canonical OpenAPI spec",
        "description": "Returns the full machine-generated OpenAPI 3.1 document covering every public endpoint. This root /openapi.json is a thin discovery proxy.",
        "operationId": "getCanonicalOpenApiSpec",
        "responses": {
          "200": {
            "description": "OpenAPI 3.1 JSON document",
            "content": {
              "application/json": {}
            }
          }
        }
      }
    },
    "/health": {
      "get": {
        "tags": ["discovery"],
        "summary": "Liveness probe",
        "operationId": "health",
        "responses": {
          "200": {
            "description": "Service is reachable",
            "content": {
              "application/json": {
                "example": { "status": "ok" }
              }
            }
          }
        }
      }
    }
  },
  "x-agent-payment-support": false,
  "x-agent-registration": {
    "supported": false,
    "reason": "VINTrakID is in closed enterprise beta. Automated agent registration is disabled. See /auth.md and /partner/signup for the human-driven onboarding flow.",
    "contact": "partners@vintrakid.com"
  }
}