---
title: "SIM Swap"
method: POST
path: "/mi/simswap/1/check"
tags: ["connectivity", "mobile-identity", "identity-sim-swap-verification"]
---

# SIM Swap

`POST /mi/simswap/1/check`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/mi/simswap/1/check`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Verify if there was a SIM swap event for a given mobile phone number and period.<br/>
API and URL may vary per country. Contact your Account Manager for implementation details.

## Request body

- C4fb96364cd87b1d1d15720880c5153ef26f58342e4ec03b9d5896f2251f17aeSimSwapCheckRequestDto: SIM Swap request object.
  - `consentGranted` boolean, required: Indicates whether you have consent from mobile phone number's owner to perform this request. All requests that do not have this property set to "true" will be rejected.
  - `phoneNumber` string, required: Mobile phone number (MSISDN) to verify. The number must be in international format.
  - `period` integer, required: SIM swap check will be verified with MNO in "period" amount of hours from when this request was received. The value should be greater than 0.

## Response `200`

OK

- object
  - `requestId` string, uuid: Unique request identifier.
  - `simSwapOccurred` boolean, nullable: Indicates whether SIM swap occurred in the requested period.
  - `networkInfo` object: Additional network information about the SIM swap.

## Other responses

- `400`: Bad request - no coverage
- `401`: Unauthorized - Platform authentication error
- `403`: Permission denied - Platform authorization error
- `422`: Unprocessable content
- `500`: Internal error - operation failed

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)