Takeover Protection (SIM Swap)

As part of CM.com's Takeover Protection measures, the Mobile Identity Services offer the option to detect a SIM swap. With this service you can check the last time the SIM of a provided phone number was swapped. SIM Swap has three different responses, depending on the serviceType in the request provided through the API.

timestamp: Returns a time in date-time format specifying the last time the SIM was swapped for the provided phone number.
24h: Returns true or false depending on if the phone number has had their SIM swapped in the past 24 hours.
range: Returns a range indicating when the last SIM swap took place.

Request

URL

POST https://api.cm.com/mobile-identity/v1/sim-swap

Headers

Content-Type: application/json
Authorization: Bearer GENERATED_TOKEN_HERE

Body

{
  "phoneNumber": "+31612345678",
  "serviceType": "timestamp"
}

Parameters

Property	Type	Required	Description
phoneNumber	string	Yes	The phone number to be checked. This must be a valid phone number in E.164 format.
serviceType	string	Yes	The type of SIM Swap response to be retrieved. Available options are `timestamp`, `24h`, and `range`.

Response

Depending on the serviceType provided in the request, the response is different.

{
    "timestamp": "2017-12-31T14:59:59Z"
}

Parameters

Only one of the following properties will be returned.

Property	Example	Description
timestamp	'2024-01-01T00:00:00Z'	Date and time of the last SIM Swap in ISO 8601 format.
24h	false	`true` or `false` regarding whether the last SIM swap took place in the last 24 hours.
range	'gt': 1209600, 'lt': 604800	Range of values in seconds that contain the last SIM Swap. `gt` is the upper boundary and `lt` is the lower boundary. If the value for `lt` is `-1`, the last SIM swap is older than the `gt` value.