Read-only
No create, update, or delete operations — POST, PUT, DELETE are not available.
OneRoster APIs
Untis Platform implements the IMS Global OneRoster v1.1 specification, giving integration partners standards-based, read-only access to organizational and enrollment data. If your platform already speaks OneRoster, you can consume Untis Platform roster information without learning proprietary data structures.
Available entities
Section titled “Available entities” Organizations & Schools School and district organizational structures.
Users Students, teachers, and all users — filterable by role.
Classes Teaching groups (mapped to Untis Platform lessons).
Academic Sessions School years, terms, and grading periods.
Enrollments User-to-class membership relationships.
Supported features
Section titled “Supported features”| Feature | Details |
|---|---|
| Operations | GET only — all endpoints are read-only |
| Filtering | Filter by dateLastModified for incremental sync |
| Pagination | limit and offset parameters on every list endpoint |
| Role filtering | Retrieve users by specific role (student, teacher) |
Limitations
Section titled “Limitations”User-assigned data only
Students and teachers without user accounts are not returned. For complete master-data, use the Untis Platform APIs.
Current school year
Enrollment data is limited to the active school year. Historical and future enrollments are not exposed.
No gradebook or demographics
Gradebook (lineItems, results), resources, and demographics endpoints are not implemented.
Terminology mapping
Section titled “Terminology mapping”OneRoster and Untis Platform use different names for the same concepts:
| OneRoster term | Untis Platform term | Notes |
|---|---|---|
| Class | Lesson | A class in OneRoster = a lesson (Unterricht) in Untis Platform |
| Course | Subject | Not directly exposed in OneRoster APIs |
| Organization | School | Treated as equivalent — /orgs and /schools return the same data |
| Academic Session | School Year / Term | Hierarchical time periods for organizing instruction |
Related guides
Section titled “Related guides” Which API to Choose Side-by-side comparison to help pick the right API family.
Common API Concepts Pagination, sorting, and filtering — shared across both families.
OneRoster v1.1 Specification Full IMS Global specification for data models and endpoints.