---
title: Get a List of Devices
framework: devicemanagement
role: symbol
role_heading: Web Service Endpoint
path: devicemanagement/fetch-devices
---

# Get a List of Devices

Get a list of devices that are managed by the server.

## URL

POST https://mdmenrollment.apple.com/server/devices

## Response Codes

200 OK: 400 Bad Request:  INVALID_CURSOR: An invalid cursor value was provided. EXHAUSTED_CURSOR: The cursor had returned all devices in previous calls. USER_AGENT_INVALID:  The User-Agent header is invalid. USER_AGENT_MISSING:  The User-Agent header is missing or has no assigned value.

## Discussion

Discussion This request fetches a list of all devices that are assigned to this MDM server at the time of the request. This service should be used for loading an initial list of devices into the MDM server’s data store. Once the list of devices is loaded, Sync the List of Devices to update the list. This request provides a limited number of entries per request, using cursors to provide position information across requests.

## HTTP Body

The request for a list of devices.

## Topics

### Request and Response

- [FetchDeviceRequest](devicemanagement/fetchdevicerequest.md)
- [FetchDeviceResponse](devicemanagement/fetchdeviceresponse.md)

## See Also

### Device management

- [Activation Lock a Device](devicemanagement/activation-lock-devices.md)
- [Get Device Details](devicemanagement/device-details.md)
- [Sync the List of Devices](devicemanagement/sync-devices.md)
- [Disown Devices](devicemanagement/disown-devices.md)
- [Get Beta Enrollment Tokens](devicemanagement/get-beta-enrollment-tokens.md)