# Get the Last Reported Information for a Device ### `POST /dm/v1/devices/lastreported` Use this endpoint to retrive the latest sensor details. ## Header Parameters The request header must set the content-type to JSON, contain a current ThingSpace authorization token and a current VZ-M2M session token. For more details on how to get these tokens, visit [Getting Started](https://thingspace.verizon.com/documentation/api-documentation.html#/http/connectivity-management/guides/getting-started/introduction-to-the-connectivity-management-api). |Parameter Name|Data Type|Description| |-----|-----|-----| | **Authorization** *(required)* | string | HTTP Authorization request header containing a valid Bearer token: `Authorization: Bearer {token}` | | **VZ-M2M-Token** *(required)* | string | A valid session token returned by a Connectivity Management `POST /session/login` request. | | **Content-Type** *(required)* | string | Must be `application/json`. | ## HTTP Request [PATCH https://thingspace.verizon.com/api/dm/v1/devices/lastreported](/docs/specialized-apis/sensor-insights/api-endpoints/devices/sensorinsightslastreportedtimerequest) ## Request Parameters **Note:** All parameters are required unless marked *(optional)* | Parameter | Data Type | Description | | ---------- | --------- | ------------ | | **accountname** | string | The numeric name of the account and must include leading zeros. | | **resourceidentifier** | object|Details about the device being queried. | | **deveui** |string| The unique EUI64 address of the device. | | **deviceid** |string| The UUID of the device. This is assigned to the device at Onboarding. | | **esn** |integer| The Electronic Serial Number of the device and is a 64-bit integer. | | **iccid** |string| The 20-digit Integrated Circuit Card ID (SIM card ID). | | **imei** |integer| The 15-digit International Mobile Equipment Identifier. | | **imsi** |integer| The International Mobile Subscriber Identifier and is a 64-bit integer. | | **mac** |string| The Media Access Control address of the device, listed on the device in the format XX-XX-XX-XX-XX-XX or XX:XX:XX:XX:XX:XX. | | **manufacturer** |string| The name of the manufacturer of the device. | | **meid** |string| The 56-bit Mobile Equipment ID. | | **msisdn** |string| The Mobile Station International Subscriber Directory Number. In the USA, this is 1+ a 10-digit phone number. | | **node_uuid** |string| The UUID of the node the device is associated with. This is a 34 or 36-bit alphanumeric value. | | **qrcode** |string| The numeric value of the Quick Response (QR) code on the device. | | **serial** |string| The device's serial number. | ## Request Body Example Request: ```json { "accountname": "0000123456-00001", "resourceidentifier": { "deveui": "The unique EUI64 address of the device", "deviceid": "The UUID of the device", "esn": 223372036854775800, "iccid": "The 20-digit ICCID", "imei": 223372036854775, "imsi": 223372036854775800, "mac": "The Media Access Control address", "manufacturer": "REOLINK", "meid": "The 56-bit Mobile Equipment ID", "msisdn": "The Mobile Station International Subscriber Directory Number", "node_uuid": "The UUID of the node the device is associated with", "qrcode": "The Quick Response (QR) code", "serial": "The device's serial number" } } ``` ## Success Response **Status 200** This is a synchronous response, so the most recent details of the device will be returned. Example Response: ```json { "event": { "accountclientid": "null", "callbackurl": "The URL of the callback listener", "createdon": "2023-10-02T15:46:34.562Z", "description": "a short description", "deviceid": "The UUID of the device", "errmsg": "provider_service_error", "fieldid": "The field ID", "fields": { "additionalProp1": "string", "additionalProp2": "string", "additionalProp3": "string" }, "fieldvalue": [ 90 ], "foreignid": "c1f178d3-eeee-ffff-gggg-0d6b7ae6022a", "id": "string", "lastupdated": "2023-10-02T15:46:34.562Z", "modelid": "The model ID of the device", "name": "User defined name of the record", "sensordataaggregation": true, "state": "success", "transactionid": "afbcc00d-eeee-ffff-gggg-38b4333fcf06", "ttl": 90, "version": "1.0", "versionid": "337bd2e8-eeee-ffff-gggg-5207992fd395" }, "timestamp": "string" } ``` ## Success Parameters | Parameter | Data Type | Description | | ---------- | -------- | ----------- | | **event** |object| Contains the device details of the last reported event. | | **accountclientid** |string| Future functionality. This value will be "null". | | **callbackurl** |string| The URL of the callback listener. | | **createdon** |string ($date-time)| The timestamp of when the record was created.| | **description** |string| A description of the record. | | **deviceid** |string|The UUID of the device. This value is assigned when the device is onboarded.| | **errmsg** |string| A system generated error message. | | **fieldid** |string| The description of the value in `fieldvalue`. | | **fields** |object| Contains the device configuration details as well as device identifier details. | | **fieldvalue** |array| The value of the type described in `fieldid`.| | **foreignid** |string| The UUID value of the user's Enterprise Customer Profile Database (ECPD) account. A UUID is a 32 to 36-bit alphanumeric string. | | **id** |string| The UUID of the resource record. A UUID is a 32 to 36-bit alphanumeric string. | | **lastupdated** |string ($date-time)| The timestamp of when the last update to the record was made. | | **modelid** |string| The model ID of the device. | | **name** |string|The user defined name of the record.| | **sensordataaggregation** |boolean| A flag to show if data is being aggregated ( **true** ) or not ( **false** ). | | **state** |string| The status of the request made. This will be either `success` or `failed`. | | **transactionid** |string| The UUID of this transaction. A UUID is a 34 or 36-bit alphanumeric value. | | **version** |string| The resource version. | | **versionid** |string| The UUID of the resource version. A UUID is a 32 to 36-bit alphanumeric string. | | **timestamp** |string| A time and date of when this data was provided. | ## Failure Responses Example Response: ```json { "error": "Error name or code", "error_description": "A longer error description.", "cause": "A cause for the error" } ```