---
title: Read a user
framework: rosterapi
role: symbol
role_heading: Web Service Endpoint
path: rosterapi/returns-a-specific-user-in-an-apple-school-manager-organization
---

# Read a user

Read a user in an Apple School Manager organization.

## URL

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

## Path Parameters

userId: The identifier from the user. Use the id field from the User object.

## 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 user with the given userId 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

Integrating with Roster API and Sign in with Apple

## Discussion

Discussion Access to the users resource requires authorization to the edu.users.read scope. Example

## See Also

### Information about users

- [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)
