---
title: Sync the List of Devices
framework: devicemanagement
role: symbol
role_heading: Web Service Endpoint
path: devicemanagement/sync-devices
---

# Sync the List of Devices

Get updates about the list of devices the server manages.

## URL

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

## Response Codes

200 OK: 400 Bad Request:  CURSOR_REQUIRED: The cursor value was not provided in the request body. INVALID_CURSOR: An invalid cursor value was provided. EXHAUSTED_CURSOR: The cursor had returned all devices in previous calls. EXPIRED_CURSOR: The provided cursor is older than 7 days. 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 The sync service depends on a cursor returned by the fetch device service. It returns a list of all modifications (additions or deletions) since the specified cursor. The cursor passed to this endpoint should not be older than 7 days. This service may return the same device more than once. You must resolve duplicates by matching on the device serial number and the op_type and op_date fields. The record with the latest op_date indicates the last known state of the device in ADE.

## HTTP Body

The request to sync the list of devices.

## Topics

### Request

- [SyncDeviceRequest](devicemanagement/syncdevicerequest.md)

## See Also

### Device management

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