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

# List users

List users in an Apple School Manager organization.

## URL

GET https://api-school.apple.com/rosterapi/v1/users

## Query Parameters

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

## Response Codes

200 OK: The request was successful. 401 Unauthorized: The access token was invalid. 403 Forbidden: Access to the requested user was forbidden. 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.

## 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 in a class](rosterapi/returns-a-users-for-an-apple-school-manager-class.md)
- [Users](rosterapi/users.md)