In OneRoster, a class represents a teaching group where instruction occurs — the unit where students and teachers are enrolled, attendance is recorded, and timetable scheduling happens.
| Service call | Endpoint |
|---|---|
getAllClasses | {{API_URL}}/ims/oneroster/v1p1/classes |
getClass | {{API_URL}}/ims/oneroster/v1p1/classes/{id} |
Lesson (Unterricht) = OneRoster Class
A teaching group for a specific subject, taught by one or more teachers, with enrolled students from one or more Untis Platform Classes.
Example: “Biology - 9th Grade - Mr. Smith” is exposed as a OneRoster class.
Class (Klasse) ≠ OneRoster Class
An administrative/organizational student group (e.g., “9A”, “10B”) — typically a homeroom or form group. This information appears in metadata extensions, not as a separate OneRoster entity.
| Untis Platform term | English | OneRoster equivalent |
|---|---|---|
| Unterricht | Lesson | Class |
| Klasse | Class (organizational group) | (metadata only) |
Untis Platform enriches OneRoster class objects with additional metadata:
| Metadata field | Description | Example |
|---|---|---|
| Untis Platform-Classes ID | ID and name of the organizational classes | "1A", "9B" |
| From- and to-date | Date range of the lesson | "2025-09-01" |
| Lesson name | Optional name of the lesson | "Biology Lab" |
Fetch all classes (lessons), sorted by title. Uses the shared OneRosterClient — see the Users page for the full client setup.
OneRosterClient client = new OneRosterClient(tenantId, clientId, password, new ObjectMapper());OneRosterResponse<Map<String, Object>> result = client.list( "/ims/oneroster/v1p1/classes", "classes", Map.class, null, "title", 100, 0);
List<Map<String, Object>> classes = result.items();classes.forEach(c -> System.out.println(c.get("title")));