{
  "openapi": "3.1.0",
  "info": {
    "title": "Sri Venkatesa Perumal College of Engineering & Technology — Public Data API",
    "version": "1.0.0",
    "description": "Read-only, machine-readable institutional data for AI assistants and agents: programmes, fees, eligibility, admissions and placements. Derived from the same content that powers the website.",
    "contact": {
      "email": "admissions@svpcet.org"
    }
  },
  "servers": [
    {
      "url": "https://svpcet.org"
    }
  ],
  "paths": {
    "/api/v1": {
      "get": {
        "summary": "Discovery index",
        "description": "This index of all available endpoints.",
        "responses": {
          "200": {
            "description": "Success — application/json"
          }
        }
      }
    },
    "/api/v1/college": {
      "get": {
        "summary": "Institution profile",
        "description": "Name, accreditation, address, contacts and totals.",
        "responses": {
          "200": {
            "description": "Success — application/json"
          }
        }
      }
    },
    "/api/v1/programmes": {
      "get": {
        "summary": "All programmes",
        "description": "Every sanctioned programme with seats, fees, eligibility and careers.",
        "responses": {
          "200": {
            "description": "Success — application/json"
          }
        }
      }
    },
    "/api/v1/programmes/{slug}": {
      "get": {
        "summary": "One programme",
        "description": "A single programme by slug (e.g. cse, cse-aiml, mba).",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Programme slug, e.g. cse, cse-aiml, mba."
          }
        ],
        "responses": {
          "200": {
            "description": "Success — application/json"
          },
          "404": {
            "description": "Programme not found"
          }
        }
      }
    },
    "/api/v1/fees": {
      "get": {
        "summary": "Fee structure",
        "description": "Convener/management fees per level with parsed INR values.",
        "responses": {
          "200": {
            "description": "Success — application/json"
          }
        }
      }
    },
    "/api/v1/eligibility": {
      "get": {
        "summary": "Eligibility & documents",
        "description": "Per-level eligibility, entrance exams and required documents.",
        "responses": {
          "200": {
            "description": "Success — application/json"
          }
        }
      }
    },
    "/api/v1/admissions": {
      "get": {
        "summary": "Admissions process",
        "description": "Procedure, quotas, scholarships and the admissions office.",
        "responses": {
          "200": {
            "description": "Success — application/json"
          }
        }
      }
    },
    "/api/v1/placements": {
      "get": {
        "summary": "Placements",
        "description": "TPO, metrics, recruiters and the training programme.",
        "responses": {
          "200": {
            "description": "Success — application/json"
          }
        }
      }
    }
  }
}