Skip to main content
The VClasses REST API lets you programmatically manage PDF homework, quizzes, and grading from any HTTP client. Use it to build integrations that automate submission workflows, retrieve grading data, or embed VClasses functionality into your own tools and dashboards.

​
Base URL

All endpoints share a single base URL. Every request you make must begin with this prefix:

​
API Version

The current API version is v3. The version segment is part of every endpoint path — you must include it in every URL you construct. There is no versionless alias.

​
Request Format

​
Required Headers

Include these headers on every request:

​
POST Requests — JSON Body

When sending a JSON payload in a POST request, add the Content-Type header:

​
POST Requests — File Upload

When uploading a file (such as a PDF submission), use multipart form data instead:

​
Response Format

All successful responses return JSON. Paginated list endpoints return a standard pagination envelope with the following structure:
Non-paginated success responses return the resource object or a confirmation message directly in the JSON body.

​
Endpoints Summary

All endpoint paths in the table above are relative to https://app.example.com. Combine the base URL with the path to form a complete request URL — for example, https://app.example.com/api/v3/admin/homeworks.