---
title: User
framework: rosterapi
role: symbol
role_heading: Object
path: rosterapi/user
---

# User

A user in an Apple School Manager organization.

## Declaration

```data
object User
```

## Properties

dateCreated: The date the record was created in ASM, formatted in ISO 8601. dateLastModified: The date the user record was last modified in ASM, formatted in ISO 8601. email: The email address of the user. Not all student accounts have an email address. familyName: The user’s last name. givenName: The user’s first name. grade: If the user is a student, the user’s grade. id: A unique identifier for the user. Use it to request information for one user in the Read a user endpoint. middleName: The user’s middle name. roleLocationMapping: A list that maps between the user’s roles and the Location for each role. roles: A list of roles this user fills in the Apple School Manager organization. Possible values are Student, Instructor, and Staff.

## See Also

### Information about users

- [Read a user](rosterapi/returns-a-specific-user-in-an-apple-school-manager-organization.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)