Contents

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

NameTypeDescription
classId Requiredstring

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

Query Parameters

NameTypeDescription
limit Optionalstring

The maximum number of user records to return. The default limit is 100.

role Optionalstring

The role of the user in the class.

pageToken Optionalstring

A token to retrieve the next set of records when the number of users is greater than the limit parameter.

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
Users

The request was successful.

401Unauthorized

The access token was invalid.

403Forbidden

Access to the requested user was forbidden.

404Not 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.

500Internal Server Error

The server encountered an internal error.

Mentioned in

Discussion

Example

See Also

Information about users