---
title: "List device mapping"
method: GET
path: "/endpoints/v1/devicemappings"
tags: ["Endpoints"]
---

# List device mapping

`GET /endpoints/v1/devicemappings`

## Request

- Base URL: `https://apis.druva.com/insync`
- URL: `https://apis.druva.com/insync/endpoints/v1/devicemappings`
- Auth: API key in header `Authorization`

Returns a list of user-to-device mapping created to perform a mass deployment in a non-AD/LDAP environment or perform bulk replace of devices.

## Query parameters

- `emailID` string
- `deviceIdentifierType` 'serial-number' | 'uuid' | 'hostname'
- `deviceIdentifier` string
- `restoreData` 'All' | 'Data' | 'System'

## Response `200`

OK

- DeviceMappingList
  - `totalSize` integer: The total number of device mappings listed on the result page. Example - 3
  - `nextPageToken` string: The token to access next page of results. This parameter will be empty for the last page of results.
  - `imdMappings` DeviceMappingListResponse[]
    - `mappingID` string: The id of the device mapping in inSync. Example - 3452rw6
    - `emailID` string: The email address of the user. Example - ernie.carter@druva.com
    - `userName` string: The username of the user in inSync. Example - Ernie Carter
    - `deviceName` string: The device name linked to the user in inSync.
    - `deviceIdentifierType` string: The unique id type of the device in inSync. Example - Serial Number
    - `deviceIdentifier` string: The unique id of the device in inSync. Example - Po3XF
    - `oldDeviceName` string: The old device name linked to the user in inSync. Example - Ernie Carter's Old Macbook
    - `restoreData` string: The type of data restore performed on the new device. Example - SYSTEM
    - `createdTime` string, date-time: The date and time when the device mapping was created. Example - 2019-10-25T00:00:00Z

## Other responses

- `400`: Bad Request
- `401`: The request did not include an authentication token or an expired authentication token was supplied.
- `403`: Access denied: Insufficient permissions. User requires specific access rights and minimum permissions. Details: https://help.druva.com/en/articles/15069296
- `404`: The requested resource was not found.
- `422`: The request was well-formed but was not processed due to semantic errors.
- `500`: The request was not processed due to an internal error in inSync Cloud.
- `501`: Requested HTTP method is not implemented.

---

[API](https://skmtc.dev/druva/apis/insync-cloud.md) - [All operations](https://skmtc.dev/druva/apis/insync-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/druva/apis/insync-cloud/revisions/a0ce6d05033c?raw)