---
title: "OneRoster explained: rosters and grades for edtech | Quantlix"
description: "OneRoster is the 1EdTech standard for sharing class rosters, enrollments and grades between school systems and learning tools. Learn what version 1.2 covers."
canonical: "https://quantlix.com/en/standards/oneroster/"
last-updated: 2026-11-16
---

Source: https://quantlix.com/en/standards/oneroster/
Language: en
Description: OneRoster is the 1EdTech standard for sharing class rosters, enrollments and grades between school systems and learning tools. Learn what version 1.2 covers.

**OneRoster** [Learning technology](https://quantlix.com/en/standards/#learning)

# OneRoster: the standard for school rosters and grades

OneRoster is the 1EdTech standard for exchanging class rosters, enrollments, grades and resource assignments between student information systems and learning tools, by CSV file or REST web services.

[Discuss your project](https://quantlix.com/en/contact/) [Read the key points](https://quantlix.com/en/standards/oneroster/#standard-overview)

## At a glance

**Full name**

OneRoster Version 1.2, covering the Rostering, Gradebook and Resource services

**Published by**

1EdTech Consortium (formerly IMS Global Learning Consortium)

**Type**

Technical specification (data exchange standard)

**Current version**

OneRoster 1.2, Final Release; first published 6 June 2022, current documents issued 19 September 2022

**Applies to**

Student information systems, learning platforms, rostering services and the edtech tools that receive class, enrollment and grade data

**Last reviewed**

November 16, 2026 (2026-11-16)

## In plain terms

### Key points

- OneRoster gives schools one standard way to send rosters to learning tools and receive grades back.
- Version 1.2 has three services: Rostering, Gradebook and Resource, each available over REST and CSV.
- REST access in 1.2 requires OAuth 2.0 bearer tokens; the older OAuth 1.0a signing was removed.
- Separate scopes let a tool request core roster data without demographics, which supports data minimization.
- Only products listed by 1EdTech after passing its certification tests may claim OneRoster conformance.

### What is OneRoster?

OneRoster is **the 1EdTech standard for exchanging class rosters, enrollments and grades between a student information system (SIS) and the learning tools a school uses**. It describes people, courses, classes and results the same way everywhere, so a tool can set up its classes automatically and send marks back without a custom integration for every district.

The benefit is felt in classrooms. Rosters stay current as students join or change classes, new tools are ready on the first day of term, and teachers do not retype grades into a second system. Student information systems, learning platforms, assessment tools and rostering services all use it, which is why one connection can serve many schools.

### What OneRoster covers

- **Rostering service.** Organizations, academic sessions, courses, classes, users and enrollments, plus optional demographics.
- **Gradebook service.** Line items, results, categories and score scales, with assessment line items and results for tests that sit outside a class.
- **Resource service.** Which digital resources are allocated to classes, courses and users, without providing access to the resources themselves.
- **CSV binding.** A set of CSV files exchanged as a zip with a manifest, supporting bulk and delta processing for scheduled syncs.
- **REST binding.** JSON web services described in OpenAPI, with filtering, sorting and paging for near real-time exchange.

### What changed in version 1.2

OneRoster 1.2 reached Final Release in 2022 and remains the current version. The changes that matter most to engineers are:

- **Security.** OAuth 1.0a message signing was removed. REST services now require **OAuth 2.0 bearer tokens obtained with the client credentials grant**, in line with the 1EdTech Security Framework.
- **Scopes.** Access is split into scopes, for example core roster data, demographics and the full roster, so a tool asks only for what it needs.
- **A richer user model.** Users can hold several roles across organizations, and a userMasterId carries a definitive identifier alongside the interoperability sourcedId.
- **Assessment results.** A profile for the Gradebook service handles assessments that happen outside a class.
- **Regional flexibility.** The US-specific CEDS vocabularies were removed so other regions can apply their own.

Many districts and vendors still exchange 1.1 data, and 1EdTech continues to publish both versions, so integrations often support both during a migration.

### How it shows up in software projects

- **Stable identifiers.** The sourcedId is the join key across syncs, and records are matched carefully when a district re-imports or merges data.
- **Delta and deletion handling.** Status values and last-modified dates drive incremental syncs, and dropped enrollments remove access promptly.
- **Least-privilege access.** Tools request only the roster, demographics or gradebook scopes they need, which supports the commitments schools make under [FERPA](https://quantlix.com/en/standards/ferpa/).
- **Grade sync rules.** Results go to the right line item, with clear behavior for rescoring, late work and grades the teacher changes in the SIS.
- **Validation before import.** Files and API responses are checked before they change live data, and districts get readable reports when something is incomplete.

### How we work with OneRoster

We build OneRoster consumers and providers for edtech products and district platforms: CSV import pipelines, REST clients and servers, identity matching and grade sync, within our [enterprise applications](https://quantlix.com/en/services/enterprise-applications/) work. OneRoster often sits beside [LTI](https://quantlix.com/en/standards/lti/), which handles the launch from each course while OneRoster keeps the classes and grades in step.

Certification comes from 1EdTech after its own testing, and only listed products may claim conformance. We help you prepare for that testing and document how your integration behaves. Rostering is one part of our wider work in [education](https://quantlix.com/en/industries/education/).

## Where it applies

Industries where this standard often shapes the work.

- ### [Education](https://quantlix.com/en/industries/education/)

  Learning platforms, student services and institutional operations

## Related standards

[All standards](https://quantlix.com/en/standards/)

- LTI

  ### [Learning tool launch and integration](https://quantlix.com/en/standards/lti/)

  LTI is the 1EdTech standard that lets a learning platform such as an LMS launch external tools securely, passing user, role and course context and, with LTI Advantage, exchanging grades and rosters.
- FERPA

  ### [US student education records privacy](https://quantlix.com/en/standards/ferpa/)

  FERPA is the US federal law that protects the privacy of student education records, giving parents and eligible students rights to see and correct them and to control most disclosures by schools.
- xAPI

  ### [Learning experience data and records](https://quantlix.com/en/standards/xapi/)

  xAPI is the Experience API standard, published by IEEE as 9274.1.1-2023, for recording learning and performance activity as simple statements and exchanging them with a Learning Record Store.

## Services that support this work

The services we usually bring to projects that involve this standard.

[View all services](https://quantlix.com/en/services/)

### [Enterprise applications](https://quantlix.com/en/services/enterprise-applications/)

Quantlix designs and builds enterprise applications for internal workflows, business rules and system integration, with clear access controls and maintainable architecture.

### [Web application development](https://quantlix.com/en/services/web-application-development/)

Quantlix designs and builds web applications with responsive interfaces, business logic and system integrations, balancing accessibility, performance and maintainability.

### [Data analytics](https://quantlix.com/en/services/data-analytics/)

Quantlix builds analytics pipelines and business intelligence tools that turn operational data into defined metrics, useful reports and decision support.

## Questions, answered

What teams usually ask us about this standard.

**What is the latest version of OneRoster?**

OneRoster 1.2, a 1EdTech Final Release first published in June 2022, with its current documents issued on 19 September 2022. When we checked in November 2026, 1EdTech listed it as the most recent version.

**Should we use the CSV or REST version of OneRoster?**

CSV suits scheduled bulk or delta syncs, such as a nightly export from the student information system. REST suits near real-time exchange and fine-grained access. Districts differ in what their systems provide, so tools often support both.

**What changed between OneRoster 1.1 and 1.2?**

Version 1.2 requires OAuth 2.0 client credentials instead of OAuth 1.0a signing, adds scopes, gives users multiple roles and a userMasterId, and introduces an assessment results profile for the Gradebook service.

**Is OneRoster the same as LTI?**

No. OneRoster moves rosters and grades in bulk between systems, school-wide. LTI launches a tool from a course and passes the context for that one session. They are often used together.

**How does a product become OneRoster certified?**

It passes the 1EdTech OneRoster certification test suite for the version, services and role it supports, as described in the conformance and certification guide. Applying requires 1EdTech membership, and certified products appear in the TrustEd Apps Directory.

## Official sources

Read the official text before relying on any detail. What applies to you depends on your role, your location and the version in force.

- [1EdTech: OneRoster](https://www.1edtech.org/standards/oneroster)
- [OneRoster Version 1.2 specification](https://www.imsglobal.org/spec/oneroster/v1p2)
- [OneRoster 1.2 implementation and best practices guide](https://www.imsglobal.org/spec/oneroster/v1p2/impl/)

These guides explain each standard in plain terms. They are not legal advice, and they do not state that any product or organization conforms to a standard.

## Planning software around this standard?

Tell us which systems are involved and what you need to show. We will help you build the requirements in from the start.

[Discuss your project](https://quantlix.com/en/contact/)
