vClasses Documentation

vClasses is an online education platform that helps instructors and administrators deliver PDF-based homework and quizzes, collect student submissions, and provide detailed feedback — all through a simple REST API. Whether you’re building an integration, automating grading workflows, or exploring what’s possible, this documentation has you covered.

Quick Start

Make your first API call in minutes and see vClasses in action.

Authentication

Learn how to obtain and use your Bearer token for all API requests.

PDF Homework

Manage homework assignments, view submissions, and grade student work.

PDF Quizzes

Distribute PDF quizzes, collect answers, and track student progress.

What You Can Do with vClasses

vClasses gives admins and students a full workflow around PDF-based learning content:

Assign homework — attach a PDF to any class, set a deadline and description, and students receive it automatically.
Collect submissions — students upload their completed work as PDF files; submissions are stored with timestamps and downloadable as a zip.
Grade with feedback — admins assign a numeric rating (1–10) and write comments on each submission. Grading is idempotent, so you can update grades any time.
Run PDF quizzes — distribute PDF question sheets, track how many questions are included and the total grade, and collect student answer PDFs.
Review quiz submissions — see each student’s answer PDF alongside their awarded and total grade.

Explore the API

API Overview

Base URL, versioning, and request format.

Homework Endpoints

List, retrieve, and grade homework submissions.

Quiz Endpoints

List, retrieve, submit, and grade PDF quizzes.

Get your API token

Make your first request

Call GET /api/v3/admin/homeworks to list all homework classes with student submissions.

Grade a submission

Post a rating and comment to POST /api/v3/admin/homeworks/grade/{id} to provide feedback.

Explore the full API

Dive into the API Reference for every endpoint, parameter, and response schema.

⌘I