---
updatedAt: 2026-10-27T06:17:38.000Z
agentTools:
  projectIndex: https://developer.druva.com/llms.txt
---

# Get device information - v1

Returns device information using deviceID.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "3.0",
    "title": "inSync GovCloud"
  },
  "tags": [
    {
      "name": "Endpoints",
      "description": "Lists the APIs to get information about devices managed in Druva inSync."
    }
  ],
  "paths": {
    "/endpoints/v1/devices/{deviceID}": {
      "get": {
        "tags": [
          "Endpoints"
        ],
        "summary": "Get device information - v1",
        "description": "Returns device information using deviceID.",
        "security": [
          {
            "Bearer": []
          }
        ],
        "parameters": [
          {
            "name": "deviceID",
            "in": "path",
            "description": "The unique ID of device in inSync. Get the ID of a device using the ‘List all devices’ API.",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Device"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request"
          },
          "401": {
            "description": "The request did not include an authentication token or an expired authentication token was supplied."
          },
          "404": {
            "description": "The requested resource was not found."
          },
          "500": {
            "description": "The request was not processed due to an internal error in inSync GovCloud.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "501": {
            "description": "Requested HTTP method is not implemented.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://govcloudapis.druva.com/insync"
    }
  ],
  "components": {
    "securitySchemes": {
      "Bearer": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header"
      }
    },
    "schemas": {
      "Device": {
        "type": "object",
        "properties": {
          "deviceID": {
            "type": "integer",
            "format": "int64",
            "description": "The unique id of the device in inSync. Example - 12345",
            "example": 12345
          },
          "deviceName": {
            "type": "string",
            "description": "The device name in inSync. Example - Ernie Carter's Macbook",
            "example": "Ernie Carter's Macbook"
          },
          "serialNumber": {
            "type": "string",
            "description": "A unique, identifying number assigned to an individual piece of hardware by the manufacturer. Example - PX045",
            "example": "PX045"
          },
          "deviceOS": {
            "type": "string",
            "description": "The operating system of the device. Example - Mojave",
            "example": "mojave"
          },
          "deviceOSVersion": {
            "type": "string",
            "description": "The version of the operating system of the device. Example - 10.14 r34567",
            "example": "10.14 r34567"
          },
          "platformOS": {
            "type": "string",
            "description": "The operating system platform of the device. Example - darwin",
            "example": "darwin",
            "enum": [
              "win32",
              "linux2",
              "darwin",
              "android",
              "ios"
            ]
          },
          "uuid": {
            "type": "string",
            "description": "A 128-bit number used to uniquely identify device in internet. Example - TY5h67-5674r-675645",
            "example": "TY5h67-5674r-675645"
          },
          "clientVersion": {
            "type": "string",
            "description": "The inSync Client version installed on the device. Example - 6.1.0 r56746",
            "example": "6.1.0 r56746"
          },
          "deviceStatus": {
            "type": "string",
            "description": "The status of the device. Example - enabled",
            "enum": [
              "enabled",
              "disabled"
            ]
          },
          "upgradeState": {
            "type": "string",
            "description": "The upgrade state of the device.",
            "enum": [
              "NOT UPGRADABLE",
              "UPGRADABLE",
              "UPTODATE",
              "SCHEDULED",
              "UNKNOWN"
            ]
          },
          "userID": {
            "type": "integer",
            "description": "A unique id of the user in inSync.",
            "example": 1
          },
          "totalBackupData": {
            "type": "string",
            "description": "The storage quota consumed by the user.",
            "example": "40.05 GB"
          },
          "totalBackupDataInBytes": {
            "type": "integer",
            "description": "The storage quota consumed by the user (in bytes).",
            "example": 43003360051
          },
          "addedOn": {
            "type": "string",
            "format": "date-time",
            "description": "The date and time on which the device was added to inSync. Example - 2019-10-25T00:00:00Z",
            "example": "2019-10-25T00:00:00Z"
          },
          "lastUpgradedOn": {
            "type": "string",
            "format": "date-time",
            "description": "The date on which the inSync Client was last updated for the user. Example - 2019-10-25T00:00:00Z",
            "example": "2019-10-25T00:00:00Z"
          },
          "lastConnected": {
            "type": "string",
            "format": "date-time",
            "description": "The date and time on which the inSync Client last connected with inSync GovCloud. Example - 2019-10-25T00:00:00Z",
            "example": "2019-10-25T00:00:00Z"
          },
          "deviceMarkedInactive": {
            "type": "boolean",
            "description": "Devices marked as inactive. Example - true",
            "example": true
          }
        }
      },
      "Error": {
        "type": "object",
        "properties": {
          "code": {
            "type": "string",
            "example": "InsyncEndpoints-1006",
            "description": "Application specific error code"
          },
          "message": {
            "type": "string",
            "example": "Internal server error",
            "description": "Application specific error message"
          },
          "retryable": {
            "type": "boolean",
            "default": false,
            "description": "If true, retry using exponential backoff"
          },
          "data": {
            "type": "object",
            "description": "Dictionary of values present in the error message for localization. Currently, no values are available."
          }
        }
      }
    }
  }
}
```