---
title: List users in a class
framework: rosterapi
role: symbol
role_heading: Web Service Endpoint
path: rosterapi/returns-a-users-for-an-apple-school-manager-class
---

# List users in a class

List users in a class of an Apple School Manager organization.

## URL

GET https://api-school.apple.com/rosterapi/v1/classes/{classId}/users

## Path Parameters

classId: A unique class identifier. Use an identifier from the id field of Class.

## Query Parameters

limit: The maximum number of user records to return. The default limit is 100. role: The role of the user in the class. pageToken: A token to retrieve the next set of records when the number of users is greater than the limit parameter.

## Response Codes

200 OK: The request was successful. 401 Unauthorized: The access token was invalid. 403 Forbidden: Access to the requested user was forbidden. 404 Not Found: The server didn’t find a class with the given classId in the organization. 429 : The client made too many requests. The response includes an X-Retry-After header that indicates the number of seconds to wait before making another request. 500 Internal Server Error: The server encountered an internal error.

## Mentioned in

Obtaining information about people and classes

## Discussion

Discussion Example

## See Also

### 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)
- [Users](rosterapi/users.md)