openapi: 3.1.0
info:
  title: Student Progress API
  description: Live lookup of a student's practice-question progress and exam readiness.
  version: 1.0.0
servers:
  - url: https://c1demo.saurav.io
paths:
  /students:
    get:
      operationId: listStudents
      summary: List all students with their IDs and names
      description: Returns every student's ID, name, and readiness verdict. Use this to find a student's ID from their name, or to review the whole roster.
      responses:
        "200":
          description: Array of student summaries
  /students/{student_id}:
    get:
      operationId: getStudentProgress
      summary: Get live progress for one student by ID
      description: >
        Returns the student's current completion, rolling accuracy, weakest
        domain, and readiness verdict. This data is live and changes daily;
        it is never available in uploaded documents.
      parameters:
        - name: student_id
          in: path
          required: true
          description: The student's ID (for example 1) or first name (for example Priya).
          schema:
            type: string
      responses:
        "200":
          description: Student progress record
        "404":
          description: No student with that ID