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

# List device mapping

`GET /endpoints/v1/devicemappings`

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` DeviceMappingCreate[]
    - `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

## Other responses

- `400` — Bad Request
- `401` — The request did not include an authentication token or an expired authentication token was supplied.
- `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 GovCloud.
- `501` — Requested HTTP method is not implemented.

---

[API](https://skmtc.net/druva/apis/authentication.md) · [All operations](https://skmtc.net/druva/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/druva/authentication/revisions/2af2bf148b25/schema)