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

# List locations

Returns a list of locations in an Apple School Manager organization.

## URL

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

## Query Parameters

limit: The maximum number of locations to return. The default is 100. pageToken: A token for paging through a large number of results. If the number of locations in the organization is greater than the limit parameter, pass the token returned in Locations.

## Response Codes

200 OK: The request was successful. 401 Unauthorized: The access token was invalid. 403 Forbidden: You don’t have permission to access the locations. 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 Access to the locations resource requires authorization to either the edu.users.read or edu.classes.read scope. Example

## See Also

### Information about locations

- [Read a location](rosterapi/returns-a-specific-location-in-an-apple-school-manager-organization.md)
- [Location](rosterapi/location.md)
- [Locations](rosterapi/locations.md)