Every endpoint returns JSON. Metadata responses are cached for a day, and course level responses are never cached, so that a shared cache cannot hand a course list to somebody who was not allowed to read it.
The course level data is the scheme table the calculator uses. A semester response carries the course codes, the titles, the credits and the course types, which is enough to compute an SGPA without asking the site for anything else.
curl https://dev.vtu.drshn.tech/api/schemes/2022/branches/cs/semesters/3 \
-H "X-API-Key: your-key"Scheme index
The list of schemes with their regulation code, semester range and totals.
Access: public
Response
{
"schemes": [
{
"scheme": "2022",
"name": "VTU 2022 Scheme",
"regulation": "22OB",
"stats": { "branches": 43, "courses": 1604, "credits": 4784 },
"semesters": ["3", "4", "5", "6", "7", "8"]
}
]
}Scheme summaries
The scheme index with the grade scale and the percentage rule attached to every scheme.
Access: public
Response
{
"schemes": [
{
"scheme": "2022",
"name": "VTU 2022 Scheme",
"regulation": "22OB",
"gradeScale": [
{ "grade": "O", "points": 10, "min": 90, "max": 100, "label": "Outstanding" }
],
"percentage": { "formula": "Percentage = CGPA x 10", "note": "..." }
}
]
}One scheme
The rules, the totals and the semester list of one scheme. The courses are not in this answer, they are read one branch and one semester at a time.
Access: public
Parameters
Response
{
"scheme": "2022",
"name": "VTU 2022 Scheme",
"regulation": "22OB",
"gradeScale": [],
"percentage": {},
"semesters": ["3", "4", "5", "6", "7", "8"],
"stats": { "branches": 43, "courses": 1604, "credits": 4784 },
"branchCount": 43,
"branches": "/api/schemes/2022/branches"
}Branches of a scheme
The branch list of a scheme with the course and credit totals of each branch. The list is paginated.
Access: public
Parameters
Response
{
"scheme": "2022",
"count": 43,
"limit": 50,
"offset": 0,
"branches": [
{
"key": "cs",
"name": "Computer Science",
"semesters": ["3", "4", "5", "6", "7", "8"],
"stats": { "semesters": 6, "courses": 40, "credits": 120 }
}
],
"next": null
}One branch
A branch with the course count and the credit total of each of its semesters.
Access: public
Parameters
Response
{
"scheme": "2022",
"key": "cs",
"name": "Computer Science",
"stats": { "semesters": 6, "courses": 40, "credits": 120 },
"semesters": {
"3": { "courses": 8, "credits": 21 }
}
}Courses of one semester
The courses of a single semester with the credits and the course type. Only courses with credits above zero count towards the SGPA. This answer needs a developer key or a calculator session.
Access: key or session
Parameters
Response
{
"scheme": "2022",
"branch": "cs",
"semester": "3",
"count": 8,
"credits": 21,
"courses": [
{
"code": "BCS301",
"title": "Mathematics for Computer Science",
"credits": 4,
"type": "PCC/BS C"
}
]
}The whole scheme
Every branch, every semester and every course of a scheme in one answer. Five calls a day for one key.
Access: key
Parameters
Response
{
"scheme": "2022",
"regulation": "22OB",
"branches": {
"cs": {
"key": "cs",
"name": "Computer Science",
"semesters": { "3": [] }
}
},
"export": { "name": "your-key", "takenAt": "2026-01-01T00:00:00.000Z", "remainingToday": 4 }
}Open a calculator session
Exchanges the token from the calculator page for a session id and a key. Every later answer for that session is encrypted with AES-GCM. The token arrives in the X-Marksheet-Page-Token header.
Access: public
Response
{
"sessionId": "9f2c...",
"key": "base64 of 32 bytes",
"expiresAt": 1767225600000,
"limits": { "requests": 150, "bytes": 98304 }
}Every error carries the same shape. The message names the missing value and nothing else. No file path, no server detail.
{
"error": {
"code": "unknown_branch",
"message": "That branch does not exist in this scheme."
}
}