---
title: Roster API
framework: Roster API
role: collection
role_heading: Web Service
platforms: [roster api 1.0.0+]
path: rosterapi
---

# Roster API

Read information about people and classes from an Apple School Manager organization.

## Overview

Overview Roster API provides access to people and class information in Apple School Manager (ASM). Use this REST API if you need to support a workflow within your app to automatically create student or teacher records in advance of the first day of school. A typical use case is when your app requires teachers to input assignments and due dates for students in each class. Accessing the user and class information requires authorization from an administrator of the ASM organization. When you begin the Roster API authorization flow, use the scopes defined below to request the appropriate level of access: At the end of the authorization flow, use the access token you receive to access the Roster API endpoints, which you use to fetch people and class information. For more information on requesting an access token, see Token validation. Include the access token you receive in the Authorization header for every request. The Roster API associates the access token with an ASM organization. The endpoints return user and class information contained within that ASM organization. The unique account identifier from Sign in with Apple at Work & School is the same identifier provided in the Roster API user information. You may use this identifier to associate user information from the Roster API with a user signing in to your app.

## Topics

### Essentials

- [Obtaining information about people and classes](rosterapi/obtaining-information-about-people-and-classes.md)
- [Validating with the Roster API test scope](rosterapi/validating-with-the-roster-api-test-scope.md)

### Authentication

- [Integrating with Roster API and Sign in with Apple](rosterapi/integrating-with-roster-api-and-sign-in-with-apple.md)

### Information about users

- [Read a user](rosterapi/returns-a-specific-user-in-an-apple-school-manager-organization.md)
- [User](rosterapi/user.md)
- [RoleLocation](rosterapi/rolelocation.md)
- [List users](rosterapi/returns-a-list-of-users-in-an-apple-school-manager-organization.md)
- [List users in a class](rosterapi/returns-a-users-for-an-apple-school-manager-class.md)
- [Users](rosterapi/users.md)

### Information about classes

- [Read a class](rosterapi/returns-a-specific-class-in-an-apple-school-manager-organization..md)
- [Class](rosterapi/class.md)
- [List classes](rosterapi/returns-a-list-of-classes-for-an-apple-school-manager-organization.md)
- [Classes](rosterapi/classes.md)

### Information about locations

- [Read a location](rosterapi/returns-a-specific-location-in-an-apple-school-manager-organization.md)
- [Location](rosterapi/location.md)
- [List locations](rosterapi/returns-a-list-of-locations-for-an-apple-school-manager-organization.md)
- [Locations](rosterapi/locations.md)

### Information about the organization

- [Read the organization](rosterapi/returns-organization-infrmation.md)
- [Organization](rosterapi/organization.md)
- [Domain](rosterapi/domain.md)