--- title: "Device Information" method: GET path: "/devices/info" tags: ["Devices"] --- # Device Information `GET /devices/info` This function is used to request information regarding the status of a specific Commerce Engine or UTG-controlled PIN pad. Depending on the type of device in use, this request may return a variety of device information in the response, including the types of encryption keys injected on the device. *Note: The GET request does not support a request body. Sending an empty request body may result in an error.* **Integration Methods:** - Commerce Engine For On Premise - Locally Installed UTG See the [Integration Methods](/guides/quickstart#integration-methods) and [URLs Section](/guides/quickstart#urls) sections of the Development Quick Start guide for details regarding each processing option. ## Headers - `TerminalId` string - `InterfaceVersion` string, required - `InterfaceName` string, required - `CompanyName` string, required - `AccessToken` string, uuid, required ## Response `200` Request was processed - union - DevicesInfoComeng - `result` object[] - `dateTime` string, ISO 8601 — The date and time in ISO 8601 format including the timezone offset (yyyy-mm-ddThh:mm:ss.nnn+hh:mm). Must be sent as the local date/time of the merchant. For example, a request processed at a merchant in the Pacific time zone at 9:18am on April 15th 2021 would be sent as 2021-04-15T09:18:23.283-07:00 - `device` object - `terminalId` string — Terminal ID configured for the device. - `serialNumber` string — Specifies the serial number of the device. - `manufacturer` 'Ingenico' | 'Innowi' | 'PAX' | 'Verifone' | 'Castles' | 'Miura' — Specifies the company which manufactured the device. - `model` string — Specifies the model of the device. - `hardware` object - `cpu` string — The CPU model information. - `ramMb` string — The total amount of RAM in megabytes. - `storageMbTotal` string — The amount of total storage space in megabytes. - `storageMbFree` string — The amout of free storage space in megabytes. - `storageMbUsed` string — The amout of used storage space in megabytes. - `batteryLevel` string — The current battery level on the device. Returns `null` if the device does not have a battery - `firmware` object - `firmwareVersion` string — The firmware version. - `androidVersion` string — The Android OS version. - `emvKernelVersion` string — The EMV kernel version. - `ctlsKernelVersion` string — The card brand contactless kernel versions. - `security` object - `p2peVersion` string — The P2PE application version - `pciHardwareVersion` string — The PCI hardware version - `pciFirmwareVersion` string — The PCI firmware version - `applications` object[] - `name` string — Application name - `packageName` string — Application package name - `versionName` string — Application version name - `versionCode` number — Application version code - `connectivity` object - `activeInterface` string — The network interface that is active on the device - `ip` string — The device IP address - `gateway` string — Default gateway - `subnetMask` string — Subnet mask - `dns1` string — Primary DNS server address - `dns2` string — Secondary DNS server address - `interfaces` ConnectivityInterfaces - `ethernet` object - `mac` string — Ethernet MAC address - `isUp` 'Y' | 'N' — Returns 'Y' if the interface is up and `N` if the interface is down. - `wifi` object - `mac` string — Wi-Fi MAC address - `ssid` string — Wi-Fi SSID - `isUp` 'Y' | 'N' — Returns 'Y' if the interface is up and `N` if the interface is down. - `signalStrength` string — The Wi-Fi signal strength - `cellular` object - `imei` string — Cellular International Mobile Equipment Identity (IMEI) value - `iccid` string — Cellular Integrated Circuit Card Identifier (ICCID) - `carrier` string — Cellular mobile network carrier - `isUp` 'Y' | 'N' — Returns 'Y' if the interface is up and `N` if the interface is down. - `signalStrength` string — The Cellular signal strength - `ui` object - `language` string — ISO 639-1 2-letter language code specifying the UI display language (e.g. "en", "fr", "de"). - `supportedLanguages` string[] — Array of ISO 639-1 2-letter language codes supported by the device (e.g. "en", "fr", "de"). - `server` Server - `name` string — The name of the server that processed the request. - DevicesInfoUtgingenico - `result` object[] - `dateTime` string, ISO 8601 — The date and time in ISO 8601 format including the timezone offset (yyyy-mm-ddThh:mm:ss.nnn+hh:mm). Must be sent as the local date/time of the merchant. For example, a request processed at a merchant in the Pacific time zone at 9:18am on April 15th 2021 would be sent as 2021-04-15T09:18:23.283-07:00 - `device` object - `info` string[] — An array of details regarding a UTG-controlled device. - `terminalId` string — To prompt a specific UTG-controlled PIN pad in a request, the API Terminal ID configured in UTG TuneUp must be specified in this field. - `server` Server - `name` string — The name of the server that processed the request. - DevicesInfoUtgverifone - `result` object[] - `dateTime` string, ISO 8601 — The date and time in ISO 8601 format including the timezone offset (yyyy-mm-ddThh:mm:ss.nnn+hh:mm). Must be sent as the local date/time of the merchant. For example, a request processed at a merchant in the Pacific time zone at 9:18am on April 15th 2021 would be sent as 2021-04-15T09:18:23.283-07:00 - `device` object - `info` string[] — An array of details regarding a UTG-controlled device. - `terminalId` string — To prompt a specific UTG-controlled PIN pad in a request, the API Terminal ID configured in UTG TuneUp must be specified in this field. - `server` Server - `name` string — The name of the server that processed the request. ## Other responses - `400` — Error - `504` — Timeout --- [API](https://skmtc.dev/shift4/apis/shift4-payment-api.md) · [All operations](https://skmtc.dev/shift4/apis/shift4-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/shift4/shift4-payment-api/revisions/b923fc55b203/schema)