---
title: Check-in for Threat Response Matrix update
slug: cps-guide/mdm-epmm/check-in-for-threat-response-matrix-update
createdAt: 2026-10-06T07:45:20.715Z
---

Mobile Threat Detection vendors use this API to notify their agent in our integrated client to immediately check-in with their management service to receive the latest Threat Response Matrix (TRM). This ensures that their agent is working with the most recent application, network, and device threat information, rather than waiting for the next regularly scheduled check-in event. This API consists of a command and optional payload (URL) that vendors can use to work with GUIDs instead of mdm-identifiers.The API returns the count of devices for which the push notification action successfully initiated. The API silently ignores invalid device identifiers specified in the request.

## HTTP Method

POST

## Request URI

/msa/v1/cps/device/mtd/notification

## Request parameters

| Parameter      | Description                                                                                                                                                                                                                                |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| command        | **Required**<br />**Parameter Type:** Request body<br />**Data Type:** String<br />**Possible value:** CHECKIN<br />Command to be forwarded to Mobile Treat Defense vendor.                                                                |
| identifierType | **Optional**<br />**Parameter Type:** Request body<br />**Data Type:** Enum<br />**Possible Values:** One of :<br />- MDM\_IDENTIFIER<br />- GUID<br />If not specified, the server assumes MDM identifiers.                               |
| identifiers    | **Required**<br />**Parameter Type:** Request body<br />**Data Type:** String<br />List of mdm identifiers in this format:<br />\{ "identifiers":\["mdm-id-1", "mdm-id-2"] } <br />See [List of identifiers](docId:0FgXpF4sPOcu6M7eESvy1). |
| url            | **Optional**<br />**Parameter Type:** Request body<br />**Data Type:** String<br />URL to be forwarded to Mobile Treat Defense vendor.                                                                                                     |

## Response fields

Success: HTTP Status 200, and a number result with the count of successfully checked in devices.

See [Number result](docId:0FgXpF4sPOcu6M7eESvy1)

## Example request payload

```javascript
{
  "command": "CHECKIN",
  "URL": "http://example.com/example",
  "identifiers": [
    "mdm-id-1",
    "mdm-id-2"
  ]
}
```

## Example response

```javascript
{
    "result": 2
}
```

In case all the identifiers are invalid, then response code will still be 200, with result as 0.