K-Untis

A collection of Untis API methods to fetch data from the Eduvos Untis Server.

Note

Not a product of Eduvos. Student run project.

Documentation

Version 1.2.0

Requires an active internet connection.

Main API

Logging in

val api = KUntis(creds.secret, creds.email)
api.login()

This requires the user to be a student at Eduvos. It will not work otherwise. It will return an authorization bearer token.

Fetching Student ID

This is different from the public student ID. This is an internally used ID by the WebUntis Service.

api.fetchID()

The will return a string which is the ID used to when fetching the timetable.

Fetching a TimeTable

This fetches the student's timetable. It makes use of the Date class which makes working with dates easier. You can just write it as a string in the form of "YYYY-MM-DD" (padded with 0's to makes it the correct width).

api.fetchTimetable(Date(day = 21, month = 7),Date(day = 25, month = Months.July), creds.studentID)?.toJsonString(true)

This will return a Klaxon JSON Object.

Authors

• Neo Sahadeo (Maintainer)

License

MIT License 2026