List schools
Namespace: microsoft.graph
Retrieve a list of schools for a user.
Note: If the delegated token is used, members can only see information about their own schools. Use the
...beta/education/me/schools
resource in this case.
Permissions
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.
Permission type | Permissions (from least to most privileged) |
---|---|
Delegated (work or school account) | EduRoster.ReadBasic |
Delegated (personal Microsoft account) | Not supported. |
Application | EduRoster.Read.All, EduRoster.ReadWrite.All |
HTTP request
GET /education/me/schools
GET /education/users/{id}/schools
Optional query parameters
This method supports the OData Query Parameters to help customize the response.
Request headers
Header | Value |
---|---|
Authorization | Bearer {token}. Required. |
Request body
Do not supply a request body for this method.
Response
If successful, this method returns a 200 OK
response code and a collection of educationSchool objects in the response body.
Example
Request
The following is an example of the request.
GET https://graph.microsoft.com/v1.0/education/me/schools
Response
The following is an example of the response.
Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 345
{
"value": [
{
"id": "10001",
"displayName": "Contoso High School",
"description": "Public 9-12 high school",
"status": "active",
"externalSource": "sis",
"principalEmail": "amyr@contoso.com",
"principalName": "Amy Roebuck",
"externalPrincipalId": "14007",
"highestGrade": "12",
"lowestGrade": "9",
"schoolNumber": "10001",
"address": {
"city": "Los Angeles",
"countryOrRegion": "United States",
"postalCode": "98055",
"state": "CA",
"street": "12345 Main St."
},
"createdBy": {
"user": {
"displayName": "Susana Rocha",
"id": "14012",
}
},
"externalId": "10001",
"phone": "+1 (253) 555-0102",
}
]
}